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Simplified and standardized database 
access... that’s the promise of ODBC. 
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"Sourcer combined with Windows 
Source should be mandatory for 
looking into Windows Programs." 

Sal Ricciardi - PC Magazine 


Discover the secrets the insiders use 
with Windows Source! 

Learn the numerous undocumented 
functions used by the professionals to 
perform tricks that are otherwise im¬ 
possible! 

Windows Source™ generates detailed 
listings of Windows EXEs, DLLs, and 
VxDs. See the actual Windows func¬ 
tion names used within the programs. 

Windows Source includes the follow¬ 
ing special features: 

❖ Identifies all imported function 
calls, including Windows API calls. 

❖ Labels all exports from an execu¬ 
table, DLL or device driver. 

❖ Includes Codeview symbols when 
available. 

❖ Identifies, by name, the VxD API 
entry points and services provided. 

❖ Describes DPMI, DOScall and 
VMM interrupt subfunctions. 

There is no way to get better commented 
assembly source code from Windows 
programs. Bundled with Sourcer for 
DOS binary file disassembly. 

Just $229.95! 

Call 800-648-8266 
to order now! 

\Z yZ ? V Communications, Inc. 

% ^wf •4320 Stevens Creek Blvd., Suite 275-WD 
V- San Jose, CA 95129 FAX 408-296-4441 
408-296-4224 



From 

the Editor 


I can hardly believe it, but our super-special, reserved T-shirts are now on sale to the 
public. In the past, to get a T-shirt you pretty much had to either write an article for us or 
else jump through hoops for me at a trade show ('Do you have a five-dollar bill whose 
serial number is evenly divisible by three?'). But now, for a measly $11.95 (plus S&H) you 
too can wear the awesome W/DDJ purple and gold. Soon everyone willl have one and I'll 
have to sew a patch on mine that says 'I'm The Editor.' ♦♦ I was beginning to think I 
was the only programmer who has to make lots of code work with multiple Windows 
C++ compilers. Fortunately, I was wrong. In his work for Greenleaf Software, Mark Nel¬ 
son has to make everything work with no less than four compilers (Borland, Microsoft, 
Symantec, and Watcom). I've seen both Mark's writing and programming talents in the 
past and am extremely happy to have him taking over our C++ bug coverage. ♦♦ 
Did you send us email and get no reply? We try to reply to every mail message, so 
invariably one of two things happened: your mail did not reach us or our reply did not 
reach you. I've gotten bouncebacks from several replies I sent this month. In particular, 
we have a high failure rate replying to MCI mail (what's their gateway's problem?). ♦♦ 
Also, don't forget you can send email to wdsub@rdpub.com to subscribe, renew, replace 
a missing or damaged issue for free, or access most any subscription-related service (you 
can even buy a T-shirt!). ♦♦ One of the great features of the Microsoft Developer 
Network CD-ROM is that it contains corrections for and amplifications to the often incom¬ 
plete and inaccurate documentation in the Microsoft Windows SDK. But why won't Mi¬ 
crosoft just fix their documentation? It seems like it would be no more work to simply 
revise the SDK online help file with information that currently goes into the Microsoft 
Knowledge Base and then onto the MSDN CD-ROM. The revised .hip file could just be 
distributed electronically, making life easier for Windows programmers everywhere. That 
won't happen anytime soon, so check out our new 'SDK Annotations'; you can use the 
annotation facilities of WinHelp to repair and enhance your own online SDK documenta¬ 
tion. ♦♦ Speaking of cool things that won't happen because they generate no direct 
revenues for Microsoft, why does every Windows executable have to have its own copy 
of standard ANSI C functions? Microsoft could bundle with Windows a standard DLL that 
exported most of the standard ANSI C functions. Executables could be smaller and load 
faster (competing vendors could give you the option of using their library, or linking with 
the Windows-bundled library). ♦♦ Some people would like to write portable code but 
they just don't have the tools to make it easy. I'll let you in on my secret for appearing 
to be an ANSI C expert and writing portable code: get a copy of Standard C, by Plauger 
and Brodie (Microsoft Press, 1989), a bargain at $7.95 and one of the most-used books 
on my desk. ♦♦ Want to quickly add custom FAX support to your Windows app? It 
looks like Black Ice (603-673-1019) has done the hard part for you, with their color and 
black-and-white generic device drivers. For $1,000, you can bundle them with your 
app and automatically send your print output to a fax port or even to file (producing a 
bitmap). □ 


Ron Burk 

Editor 

CIS: 70302,2566; Internet: ronb@rdpub.com (“... !uunet!rdpub!ronb") 
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Upgrades: 

(for owners of Watcom C/C++ 31 or Watcom C/C++' 1 v9.5j 

Watcom C/C++10.0 

CD-ROM Upgrade Edition $149 


The new Watcom C/C++ 10.0 
development system simplifies and acceler¬ 
ates development of high-performance, 
multi-platform 16- and 32-bit applications, j 
Watcom C/C++ 10.0 delivers productivity : 
and performance, combining our state-of- j 
the-art compiler technology with a new, 
integrated development environment I 
(IDE) and comprehensive set of tools. ^ 

New Integrated Development 
Environment and Tools The new ide is 

built to simplify the complexities of real-world 
application development and make it easy to exploit 
the high-performance, multi-platform power of 
Watcom C/C++ 10.0. In a single “project” you can 
build multiple EXEs, DLLs, and LIBs, targeting 
several different platforms. The IDE simplifies each ^ 
stage of development from compiling and linking to 
debugging and performance tuning. The package 
includes versions of the IDE and tools for all three host 
platforms (Windows 3.x, OS/2 2.x and Windows NT).. 


Watcom C/C++ 10.0 includes a source editor with syntax 
highlighting, a suite of resource editors, testing and 
monitoring tools for Windows 3.x and NT development. 


lultiple Platforms in a Single 

r Package Watcom C/C++ 10.0 supports 
development of applications targeting an 
'incredible array of platforms: DOS, Windows 
F3.x, OS/2 1.x, 32-bit DOS (includes royalty-free 
)OS extender), OS/2 2.x, Windows NT, Win32s, 
J2-bit Windows 3.x and Novell NLMs. To 
naximize the potential on individual 
^platforms, Watcom C/C++ 10.0 extends the 
^capabilities of the core, multi-platform toolset 
11 with platform-specific tools, SDKs and libraries, 
his extensive support is amplified by the cross- 
"platform capabilities of the IDE and tools, which enable 
building applications for a wide range of target 
Environments from any of the host systems. 

The Best Optimization Technology watcom C/C++ 10.0 

^combines both 16- and 32-bit compilers in a single package, providing 
Pfou with the industry-leading optimizing compiler team. PC Magazine 
"tested performance of industry standard C and C++ compilers and said: 

'“the fastest executables created during testing came from Watcom C/C++ 3 ’, 
Version 9.5, while the 16-bit version of the same compiler produced the smallest 
Executables” 1 . Now, with Watcom C/C++10.0, this competitive advantage is 
"delivered with our easy-to-use development environment and tools. 

Watcom C/C++10.0 delivers all this in a single package! 


• New integrated development environment 
hosted on Windows, OS/2 and Windows NT 

• Comprehensive suite of multi-platform 
development tools including debugger, 
browser, profiler and more 

• Professional source editor, resource editors, 
testing and monitoring tools hosted on 
Windows and Windows NT 

•Target Platforms include: 

16-bit: DOS'Windows 3.x* * OS/2 1.x 
32-bit: Extended DOS • Windows NT 
•Win32s* OS/2 2.x* 32-bit 
Windows 3.x* Novell NLM 
• AutoCAD ADS/ADI 

Suggested Retail Price: 

Watcom C/C++10.0 CD-ROM Edition & 

(CD-ROM with on-line documentation) $350 

Watcom C/C++10.0 

( CD-ROM with printed documentation) 


• Both 16-bit and 32-bit compilers for C and C++, 
the industry's best code optimizer, faster compile 
times with pre-compiled headers, C++ supports 
templates, exception handling and the Microsoft 
Foundation Class library (MFC) 

• Licensed components from: 

• Microsoft Windows 3.1 SDK 

• Microsoft Windows NT SDK 

• Novell NLM SDK v4.0 

•IBM OS/2 Toolkit v2.1 

• Microsoft MFC Class library 

• Includes Rational System's DOS/4GW 32-bit 
DOS extender with royalty-free distribution 

• Significantly expanded and revised 
on-line documentation 

•And more! 


The advanced multi-piatform debugger accelerates the 
development cycle by increasing the bandwidth between 
you and your application. 


1 - 800 - 265+555 


Watcom 

A Powersoft Company 


Watcom International 415 Phillip Street, Waterloo, Ontario, Canada N2L 3X2 Telephone (519) 886-3700 Fax (519) 747-4971 

* Price in US dollars. Does not include freight and taxes where applicable. Authorized dealers may sell for less. SI99 Special Offer is available until October 31,1994. Watcom and the Lightning Device are trademarks of Watcom International Corp. 
DOS/4G is a trademark of Rational Systems Inc. Other trademarks are properties of their respective owners. ©Copyright 1994 Watcom International Corp. 'PC Magazine, March 29,1994 
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Paul Bonneau 


Send questions to Paul via Internet as 

poulPrdpub.com 

from CompuServe: 

>INTERNET:paulPrdpub.com 
or in care of this magazine at: 

1601 W. 23rd St., Suite 200 
Lawrence, KS 66046-2700. 

Paul answers all electronic 
communications but is unable to 
respond personally to hard copy/disk 
messages. 


eE3= 

Visual C++ vl .5 

Borland C++ v4.0 


Symantec C++ v6.l 


Q Having scoured the entire DDK documentation, I must say that the Virtual 
Machine Manager (VMM) API call, which allows a Windows application to 
create a Virtual Machine (VM) and modify its attributes on the fly, is undocu¬ 
mented. This feature is used by WinExec (the protected-mode handler for INT 
21h, function 4Bh really) to create VMs for DOS program execution, by Microsoft 
Visual C++ (to create a hidden VM to launch the command-line "C compiler), 
and presumably by Borland C++ 4.0 IDE (to launch GREP and other so-called 
translators). Please note that Borland C++ 4.0, which does not require any ad¬ 
ditional VxDS, seems to implement this feature using a somewhat different 
mechanism. All the same, I will appreciate it very much if you can provide me 
with information on this particular API call. 

Atul Khare 
Atul_Khare@ccm.hf.intel.com 

A I have often wondered about this question myself - thanks for giving me 
the opportunity to finally find out what's going on! Before diving in, a 
short review of the Windows architecture might be helpful. 

You can view Windows as a layered operating system. The outermost layer 
is the documented Windows API. The innermost layer, however, is a virtual 
machine manager (VMM) that manages memory, hardware access, and execu¬ 
tion of 80386 virtual machines. Each DOS box that you spawn from Windows 
is a separate VM, and all Windows applications reside in the very first VM that 
Windows creates (the system VM). The great majority of the VMM services are 
not directly available to Windows applications, but they are directly available to 
Windows virtual device drivers (VxDS). The VMM and most VxDS are contained 
in the file win386.exe. Windows comes with VxDS that handle the problem of 
allowing multiple VMs to access individual devices (such as the serial port or 
keyboard). However, because they have access to the extensive low-level serv¬ 
ices that the VMM provides, some VxDS have little to do with physical hard¬ 
ware and more to do with manipulating memory or VMs. Such a VxD is the 
Shell VxD. 


Paul was a developer of HyperChem, a molecular modeling system, and more recently, 
of Creative Writer, a word processor for children. He works for Microsoft Corporation as 
a Software Design Engineer. The opinions expressed in this column are Paul's alone 
and not those of Microsoft 
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Sometimes you'll find you are 
held back by the limitations of 
using Visual Basic alone. 
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With the help of Crescent 
Software you can now reach 
your highest goals with ease. 


i 


We can only drop you a line, 
if you drop us one (1-800-35-BASIC). 


If you use Visual Basic because it allows 
you to create real, quality Windows appli¬ 
cations quickly with minimal effort, then 
you'll want to use Crescent Software's 
add-on tools for those same good reasons. 

We've been providing reliable software 
solutions to Basic programmers for nearly 
8 years, so we know what tools you need 
and how to deliver them to you. Plus, our 
products come with complete source code 
and example programs so you can learn 
how we write expert Visual Basic code. 

So, if you're ready, grab a hold of Crescent 
Software's Visual Basic product line, you'll 
like what you see at the top! 

"For a professional programmer writing sophisticated, real world 
applications, QuickPak Professional is a treasure trove." 

- Windows Magazine, 1993 

QuickPak Professional for Windows ($199) includes 30+ Custom 
Controls, 400+ DLL routines, 2.7 MB of sample code, 3+ MB of 
source code, 1,000 pages of documentation (2 separate volumes), 
and several time saving utilities for Visual Basic. With this kind 
of unprecedented power, you can quickly create show stopping 
Windows-based applications with ease! 

Most of the custom controls are data- 
aware. Included are masked edit controls, 
enhanced list box, and scroll bars, a cal¬ 
endar control, spin button, command 
button, and our unique form management 
control, and more! 

Separate common dialog controls are pro¬ 
vided that are easier to use and more 
powerful than those supplied with 
Microsoft's Professional Toolkit 




r Visual Basic ($99) generates listings of all keywords, 
forms, controls, properties, events, methods, variables, arrays, 
constants, and procedures by type and scope - even across 
seperate modules. 

It automatically recognizes properties and events of custom 
controls, as well as all Visual Basic 3.0 data objects. A 
unique call-tree report identifies your procedures showing the 
the hierarchy of procedures that are pres¬ 
ent but never used, and it also gener¬ 
ates a formatted listing of your source 
code complete with headers, footers, and 
a table of contents. 
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Visual Basic 
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Professional 




QuickPak 

'Professional 




More than 400 DLL routines cover a 
broad spectrum of services including array searching multi-key 
array & file sorting (including huge arrays); file and directory 
services; string parsing searching and formatting financial and 
statistical functions; missing memory functions such as Peek, 
Poke, Inp, Out, Cvx, Mkx, (including Mbf versions), VarSeg 
VarPtr, SSeg SAdd, InterruptX and much, much more. 
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Apex Software's Standard Edition bound grid control is now 
bundled with QuickPak Professional for Windows. A $69 Value 
FREE with every purchase! 



XRef can also extract quoted strings and/ 
or remarks from your source code and 
save them in a separate text file that 
can then be merged back into your pro¬ 
gram through most spell checkers. 

_ Corrected text can then be merged back 

into your program with the supplied utility program. 

Reports can be viewed with the built-in file browser or sent 
directly to your printer. XREF is an outstanding tool for doc¬ 
umenting and managing complex applications, and can save 
you hours of work. 

"The fact that less than 60 seconds are required to create 
a terminal emulator, suitable for communicating with most 
computers, is indicative of PDQComm's power." 

- BASICPro Magazine, 1993 
PDQComm for Windows ($149) is based on the MSComm 
control that Crescent Software, Inc. wrote for Microsoft's 
Visual Basic Professional edition, and it adds several im¬ 
portant enhancements. 

_ Included are background file transfers 

using ZModem, YModem, XModem, 
CompuServeB+, or Kermit protocols, 
optional display of a status dialog box 
with a percent-complete meter, and TTY, 
ANSI, DEC VT100 and VT52 terminal 
emulations. All of these features are 
extremely easy to use - just add the 
PDQComm control to a form, set a few 
properties, and within 30 seconds you're 
dialing to your favorite on-line service! 

PDQComm for Windows also includes a 64K scroll-back buffer 
session logging and a complete set of Visual Basic routines 
for handling modems (including a database of commands for 
nearly 450 modems). Extensive documentation and examples 
are provided, C source code is also available. 


1992 Readers Choice HimiI 


For international orders, choose from our list of 
authorized dealers at the bottom of this page. 


Professional for Windows ($179) provides seamless 
access to many NetBIOS, NetWare, and Windows for Work¬ 
groups network services. This product provides a compre¬ 
hensive collection of 100+ network functions that help the 
novice and professional programmer add advanced network 
capabilities to their programs written in Visual Basic. 

Services are included for Netware print and 
bindery functions; NetWare QMS functions; 
NetWare Connection functions; NetWare 
Workstation and File Server Environment 
functions; NetWare Message and Directory 
functions, NetWare TTS and 386 (F2) spec¬ 
ific functions; Windows Built-In functions; 
Windows for Workgoups functions and 
Miscellaneous Windows API functions. 






The combination of Visual Basic for Win- 

_ dows and NetPak Professional is the fastest 

way to write network-aware and network specific applications. 

NetPak Professional received the 1994 readers choice award 
1884 * by the readers of Fawcette Technical Publications Visual Basic 
RMtfWS' Choice Programmers lournal. 


"Until recently, there has been no truly useful scientific pro¬ 
gramming toolbox for Visual Basic programmers. That's where 
QuickPak Scientific for Windows makes it's grand entrance." 

- BASICPro Magazine, 1993 

Each QuickPak Scientific for Windows ($149) routine offers a 
flexible and easy to use Basic-Language algorithm to help dev¬ 
elopers solve practical and challenging problems in engineering 
science, and other technical applications. Function categories 
include linear and matrix algebra, differential equations, non¬ 
linear equations, curve fitting fast Fourier transforms, numerical 
integration, and the especially challenging 
area of numerical optimization. 

There are also provisions for statistical 
computations, manipulation of complex 
numbers, advanced trigonometry functions, 
and vector mathematics. Utility programs 
and routines are included to perform cap¬ 
abilities with Julian dates and produce very 
attractive, yet simple, plots of functional 
data. Complete source code is included, 
along with comprehensive demonstration 
programs for each routine. 




Order Toll-Free: 

1.800.35.BASIC 


PHONE: 

1.203.438.5300 



FAX: 

1.203.431.4626 


11 Bailey Avenue, Ridgefield, CT 06877-4505 


CRESCENT 

SOFTWARE, INC, 


France: Version U.S. (33) 14059-0913 

England: Grey Matter, LTD. (44) 364-53499 


Australia: Softerm Australia (61) 2438-4299 
Japan: Bunka Orient Company (22) 378-7106 


Germany: Zoschke Data GmbH (49) 4344-6166 
Holland: LeMax Company, B.V. (31) 20659-8701 
Italy: Lifeboat Associates Italia, S.R.L. (02) 4819-3440 

r 1993 Crescent Software, Inc. All Rights Reserved. Microsoft is a registered trademark and Windows, the Windows logo, and Visual Basic are trademarks of Microsoft Corporation. All other trade names referenced herein are property of their respective companies. 









































WINDOWS™ SOLUTIONS 

CONFERENCE+EXPOSITION 



...BECAUSE YOUR JOB DEPENDS ON 
CUSTOMIZED COMPUTING SOLUTIONS. 

Whether you're an MIS Manager, corporate developer, VAR or just charged with building business 
applications on Windows™, Windows Solutions is for you. Windows Solutions is the only event where 
you will get all the information you need and see all the products required to make you more successful. 


3-DAY CONFERENCE 

Over 60 informative sessions 
covering solutions-oriented 
topics and featuring the world's 
best experts and educators. 


September 7-9,1994 
San Francisco, 
Moscone Center 


Windows 


Solutions 


3-DAY EXPOSITION 

Over 250 exhibits by leading- 
edge Windows-based hardware 
and software manufacturers. Expect 
major new product announcements. 


CALL NOW 

for your free 

Windows Solutions event brochure 



ZD 

EXPOS 


Ziff Davis Exposition + Conference Company, (ZD Expos), 303 Vintage Park Drive, Foster City CA, 94404-1138 (415) 578-6900 Fax(415) 525-0194 
WINDOWS, the WINDOWS logo and WINDOWS SOLUTIONS are trademarks of Microsoft Corporation. WINDOWS SOLUTIONS and the WINDOWS logo are used under license from Microsoft Corporation. 
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It turns out that the Shell VxD provides a rather large, 
undocumented, protected-mode interface. Before the ad¬ 
vent of Windows for Workgroups and Windows-hosted 


compilers, the only major piece of software using this in¬ 
terface was WinOldAp. WinOidAp controls execution of 
DOS VMs from Windows. It is a 16-bit protected-mode 


Listing 1 shell.h — Flags and structures for Shell VxD 

j *****************************************************/ 

yfdefine fdisRetain 0x00000080 /* Retain video memory. */ 

/* shell.h */ 



/* -- Interface to Shell VxD. */ 

typedef struct 

/******★**★***★********★*****★★**************★*★****★*/ 

{ 



DWORD ib; /* 32 bit Offset. */ 

/* PIF flags. */ 

WORD 

sel; /* Selector. */ 

yfdefine fExcl 0x00000001 /* Exclusive mode. */ 

} WFP; 

/* Wide (48 bits) far pointer. */ 

yfdefine fpifBack 0x00000002 /* Runs in background. */ 



yfdefine fpifWindow 0x00000004 /* Runs in a window. */ 

typedef struct 

ffdefine fpifAltTab 0x00000020 /* Alt-Tab reserved. */ 

{ 


ffdefine fpifAltEsc 0x00000040 /* Alt-Esc reserved. */ 

DWORD 

grfpif; /* PIF flags. */ 

yfdefine fpifAltSp 0x00000000 /* Alt-Sp reserved. */ 

DWORD 

grfdis; /* Display flags. */ 

yfdefine fpifAltEnt 0x00000100 /* Alt-Ent reserved. */ 

WFP 

wfpExe; /* Path of .exe to run. */ 

^define fpifAltPsc 0x00000200 /* Alt-PrtSc reserved. */ 

WFP 

wfpArgs; /* Argument list. */ 

yfdefine fpifPrtSc 0x00000400 /* PrtSc reserved. */ 

WFP 

wfpWork; /* Working drive/dir. */ 

yfdefine fpifCtlEsc 0x00000800 /* Ctl-Esc reserved. */ 

WORD 

cpagWant; /* Desired V86 pages for VM. */ 

#define fpifldle 0x00001000 /* Detect idle. */ 

WORD 

cpagMin; /* Minimum V86 pages for VM. */ 

#define fpifNoHMA 0x00002000 /* Don't use High Mem. */ 

WORD 

wForePriority; /* Foreground priority. */ 

yfdefine fpifEmsLok 0x00008000 /* EMS memory locked. */ 

WORD 

wBackPriority; /* Background priority. */ 

yfdefine fpifXmslok 0x00010000 /* XMS memory locked. */ 

WORD 

ckbMaxEMS; /* Maximum EMS KB. */ 

yfdefine fpifFPaste 0x00020000 /* Allow Fast Paste. */ 

WORD 

ckbMinEMS; /* Minimum EMS KB. */ 

yfdefine fpifAppLok 0x00040000 /* Lock app. memory. */ 

WORD 

ckbMaxXMS; /* Maximum XMS KB. */ 

yfdefine fpifCloseE 0x40000000 /* Close on exit. */ 

WORD 

ckbMinXMS; /* Minimum XMS KB. */ 


WORD 

wdnknownl; 

/* Display flags. */ 

WORD 

wUnknown2; 

yfdefine fdisEmText 0x00000001 /* Emulate text mode. */ 

char 

szTitle[128]; 

yfdefine fdisNoText 0x00000002 /* No monitor text mode. */ 

} SEB; 

/* Shell Execute Block. */ 

yfdefine fdisNoLow 0x00000004 /* No monitor low gfx. */ 

/* End of File */ 

yfdefine fdisNoHigh 0x00000008 /* No monitor high gfx. */ 
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“At a glance, you can tell the status of any defect or 
change order, who is responsible for correcting the 
defect or implementing the change, and when the 
updated version is expected ” 




BUGBASE' FOR WINDOWS™ - THE 
PROFESSIONAL SOFTWARE DEFECT 
TRACKING TOOL. 

• GENERATE POWERFUL REPORTS & GRAPHS 

• IMPORT/EXPORT/MERGE DATABASES 

• CUSTOMIZE THE SETUP TO YOUR NEEDS i 

• NETWORK SUPPORT > 


FOR MORE INFORMATION, CALL: 
41 5-567-401 O 

■ N EUROPE, CALL: + 47 67 1 5 67 OO 
FAX: + 47 67 1 5 67 Ol 



Archimedes 
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Archimedes Software, Inc. 2159 Union Street, San Francisco, CA 94123 
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program that happens to know a lot about various com¬ 
ponents of WIN386, especially the virtual Shell device. 
When you UinExecO a DOS-hosted execution unit (e.g., 
batch file, PIF file, or binary executable), UinExecO actually 
runs WinOldAp (winoa386.modi instead. WinOldAp then uses 
the virtual Shell device's protected-mode entry point to 
create and control a DOS VM to run the specified DOS 
execution unit. 

As you have noticed, the integrated development envi¬ 
ronments (IDEs) of various Windows C++ compilers now 
also use this interface to create a hidden DOS VM in 
which to run the command-line version of their ex¬ 
ecutables (compiler, linker, resource compiler, etc.). Be¬ 


cause VMs (unlike individual Windows 3.1 applications) 
are preemptively scheduled, this lets the IDE perform a 
compilation in the background without requiring the com¬ 
piler to be totally rewritten so that it explicitly yields the 
CPU every few milliseconds. Also, although I have not 
confirmed this, Windows for Workgroups supposedly cre¬ 
ates a hidden VM (presumably to run some networking 
software). 

Any VxD can export an API function to Windows pro¬ 
grams (or any other protected-mode applications). You can 
obtain a pointer to the protected-mode API function for 
any particular VxD by issuing an INT 2Fh, function 1684h, 
with the ID of the required VxD in BX. In this case, the 
virtual Shell device's ID number is 
0017h: 


Rev Up Database 
Programming 

with Greenleaf Database Library 



typedef DWORD (FAR * LPFNKvoid); 
LPFN lpfn; 

_asm mov ax, 1684h; 

_asm mov bx, 0017h; 

_asm int 2fh; 

_asm mov word ptr [lpfn], di; 

_asm mov word ptr [lpfn + 2], es; 


Powerful Functions 


□ The SoftC Database Library 
is now the new Greenleaf 
Database Library. 

□ Unsurpassed speed and 
flexibility for access to 
industry standard database 
data, index, and memo files 
at an affordable price. 

□ Databased Advisor says, 

"SoftC Database Library has 
top ratings!" 

□ Don't be fooled by pretty 
ads—the Database Library is 
all you need to interface 
with dBASE III, dBASE IV, 
FoxPro, FoxBASE, Clipper, 
dBXL, and other xBASE files 
including new FoxPro CDX 
index files. 

□ Supports MS-DOS, 
Windows™, and is portable 
to OS/2, UNIX. 

□ Includes Windows 3.1 DLL, 
supports Microsoft, Borland 
and Zortech C/C++. 

□ Single and Multiple User; 
Network acccess fully 
supported. 

□ Database package not 
required—this product is a 
complete ISAM library. 

□ Windows DLL linkable with 
most DLL-capable compilers 
(including Visual Basic). 


All Greenleaf Libraries Feature: 

□ No royalties 

□ 90-day money-back guarantee 

□ FREE unshrouded source (ANSI & K&R) 

□ FREE unlimited tech support 

□ Top rated documentation AND online 
documentation with FREE help engine! 

□ FREE BBS access, quarterly newsletter 

□ GOLD support available: toll-free access to 
BBS, tech support and free updates—call for 
prices 

Database Library v3.22 .. $249 

■ZT Call today for complete infor¬ 
mation, demo, or to order. Mas¬ 
terCard, VISA, AmEx, approved 
purchase orders. 

1 - 800 - 523-9830 

214-248-2561 
FAX 214-248-7830 
BBS 214-250-3778 

Greenleaf Software, Inc. 

16479 Dallas Parkway, Suite 570 
Dallas, TX 75248 

fll 

GREENLEAF 


□ Request 160 on Reader Service Card o 


The single function pointer you ob¬ 
tain from the VxD in this manner 
usually provides multiple capabilities; 
the traditional protocol expects for 
the caller to specify the required serv¬ 
ice via a register, with additional pa¬ 
rameters in registers or on the stack. 
The virtual Shell device is no excep¬ 
tion. It expects a function number to 
be passed in the DX register (a little 
odd, since most other VxDS use the 
AX register for this purpose), and pro¬ 
vides handlers for functions 00h 
through 16h. 

It is a mystery what ail these func¬ 
tions in the virtual Shell device are 
for, but I did spend some time with 
the debugger (Soft-ICE/W in this case, 
since it can read the symbolic infor¬ 
mation in the debugging version of 
win386.exe supplied with the DDK) at¬ 
tempting to understand a couple of 
them, functions 0 and 3. Function 0 
is the easy one, since all it does is 
return the version number of the 
VxD in the AX register. Function 3 is 
used to create a VM. 

Function 3 accepts a far pointer to 
a parameter block via the ES and DI 
registers. For lack of a better name, I 
call it a SEB (for Shell Execution 
Block). This block specifies the name 
of a program to run, its working 
path, a command string, and various 
flags and options extracted from the 
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When protecting your software against piracy and 
unauthorized use, make sure that your protection 
system has all the following qualities: 


A GOOD HARDWARE KEY 



Hardware-based software protection systems are now the 
standard worldwide. However, not all keys are the 
same. A good key should have all the following 
features: 

l/ Compatibility and transparency. The key 
should work without any problem on your 
customers’ computers. The user should be 
able to forget the key after connecting it. 

s/ Unbreakable electronics. A customized ASIC 
(Application Specific Integrated Circuit) component 
integrated into the key to prevent reverse engineering and make cracking 
the hardware virtually impossible. 

A unique and inaccessible developer’s code burnt into the ASIC. This 


code should never be held in the key’s memory, where it can be read and 
altered. 

)/ A Read/Write Memory inside the key should be 
available. The memory should be writable in the 
field, on any PC, without any special programming 
equipment. 

\/ Very low power consumption, enabling the 
key to work even under the most adverse power 
conditions, on PCs and laptops, with or with¬ 
out a printer. 

POWERFUL SOFTWARE 

\/ A Linkable Protection Module with which calls can be made to 
the key from any point in the protected program. 

t/ An “Envelope” encryption program. Such programs enhance security 
while making it possible to protect a software application even without its 
source code. 

\/ Sophisticated antidebugging and encryption mechanisms. 




HASP'- The Professional Software 
Protection System ■> 


MacHASP - The Professional Software Protection System for the Macintosh 


HASP® OFFERS YOU 
ALL THESE FEATURES 
AND MORE: 

HASP was designed by a team of computer ex¬ 
perts, professional cryptologists, and electrical 
engineers. As a result, HASP keys are supported 
by what is probably the best software in the mar¬ 
ket, and the HASP system has worked on every 
computer it has been tried on. In addition to all 
the features mentioned above, HASP provides: 

A Full Authorization System for protecting 
dozens of programs using only one key. 

A Pattern Code Security System (PCS) which 
enables parallel processing of multiple calls by 
the Linkable Protection Module. 
v A Virus Detection option that can be in¬ 
corporated in the protected program to check 
whether it has been infected by a virus. 

\/ Several HASP keys can be connected one 
behind the other. Small physical size ensures 
maximum convenience for your customers. 

NETHASP- THE ULTIMATE 
SOFTWARE PROTECTION 
FOR NETWORKS 

>/ Only one NetHASP key is needed to run a 
protected program from any station in a network. 
NetHASP provides full support for protecting DOS 
and WINDOWS software under network 
environments, including Novell dedicated & 
non-dedicated servers, Lan Manager, Lantastic, 
Banyan, DLink, and NET-BIOS based LANs. 


LISTEN TO THE EXPERTS: 

In all the products we tested, except the HASP, 
we could see through the encrypting and 
questioning procedures... and crack them. 

CT Magazine (Germany) 
MemoHASP: ...of all the protection devices test¬ 
ed is without any doubt, the one which combines 
the best features. 

PCompatible (Spain) 

Trying to crack a program... that was protected 
utilizing all of HASP’S features - is like search¬ 
ing for the Holy Grail. 

Micro Systems (France) 
PC dongles... come with varying claims as to 
their transparency. The majority suffer from 
problems when a printer is connected... the 
DESkey and HASP-3 are not affected... 

Program Now (Britain) 
Of all keys tested, HASP is the most ambitious 
one... the quality of HASP manufacturing seems 

PYfpllpnt 

PC Compatible (France) 

An easy to use software protection system for 
the Macintosh, which ensures an effective 
defense against software piracy... 

Life is difficult for pirates... MacHASP is an 
optimal protection method, for the 
programmers... and for the users... 

Bit Magazine (Italy) | 


OPERATING 

ENVIRONMENTS 

PC: DOS, Windows, Windows-NT, Win 32s, 
OS/2, SCO Unix, SCO Xenix, 
Interactive Unix, AIX, Autocad, 

DOS Extenders, LANs 
MAC: MAC, PowerMAC (ADB port) 

NEC: DOS, Windows 
AMIGA 

AND THE BOTTOM LINE: 

We offer some of the most competitive prices 
in the market. Since 1984, HASP has enabled 
thousands of software producers in more 
than 60 countries, including several Fortune 
500 companies, to protect their software. 

Call now for your HASP evaluation kit. 


ALADDIN 


The Professional's Choice 


North 

America 


International 

Office 


France 


Aladdin Software Security Inc 

The Empire State Building 
350 Fifth Avenue, Suite 7204 
New York, NY 10118, USA 
Tel: (800)2234277 
212-564 5678 
Fax: 212-564 3377 
Aladdin Knowledge Systems Ltd. 
15 Beit Oved St., Tel Aviv, Israel 
P.O.Box 11141, Tel Aviv 61110 
Tel: 972-3-5375795 
Fax:972-3-5375796 
Aladdin France SA 
Tel: 33 1 40 85 98 85 
Fax: 331412190 56 


member of 



I Australia Conlab 3 8985685 ■ Belgium Akkermans 3 2338826 ■ Czech ATLAS 2 766085 * Chile Microloglca 2 222 1388 
| Denmark Berendsen Data 39 577100 ■ Finland ID-Systems 0 870 3520 ■ Germany CSS 201 278804 ■ Greece Unibrain 1 6856320 
I Holland Akkermans 45 241444 ■ Italy Partner Data 2 26147380 ■ Japan Athena, 3 58 213284 ■ Korea Dae-A 2 848 4481 

I New Zealand Training , 4 5666014 ■ Poland Systherm 61 475065 ■ Portugal Futurmatica 1 4116269 ■ South Africa D I.e Roux, 11 886 4704 
I Spain PC Hardware, 3 4493193 ■ Switzerland Opag 61 7112245 ■ Taiwan Teco 2-555 9676 ■ Turkey Mikrobeta 312 467 7504 
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Table 1 First group of undocumented flags 

Flag 

Meaning 

OxOOOOOOOl 

Has exclusive use of the processor when run 
full screen, majority use when run in a window. 

0x00000002 

VM will continue to run when not active. 

0x00000004 

Runs in a window. 

0x00000020 

<AltXTab> reserved for VM. 

0x00000040 

<AltXEsc> reserved for VM. 

0x00000080 

<AltXSpace> reserved for VM. 

0x00000100 

<AitXEnt> reserved for VM. 

0x00000200 

<AltXPrint Screen> reserved for VM. 

0x00000400 

<Print Screen> reserved for VM. 

0x00000800 

<ControlXEscape> reserved for VM. 

0x00001000 

VM will release idle time slice. 

0x00002000 

VM is not allowed to use High Memory. 

0x00008000 

VM s expanded memory is not pageable. 

0x00010000 

VM s extended memory is not pageable. 

0x00020000 

Fast paste from clipboard enabled (whatever 
that meansl). 

0x00040000 

VM’s application memory is not pageable. 

0x40000000 

Close VM when application exits. 


associated PIF file (when a .pif file is not explicitly exe¬ 
cuted, default values are used). This structure is presented 
(to the best of my knowledge) in Listing 1, shell.h. 

You can find a discussion of PlFs in Mike Maurice's arti¬ 
cle 'The PIF File Format, or, Topview (sort of) Lives!' in 
Andrew Schulman's 'Undocumented Corner' in the July 
1993 issue of Dr. Dobb's Journal. Of particular interest are 
the sets of PIF flags for controlling the behavior of the 


Table 2 Second group of undocumented flags 

Flag 

Meaning 

0x00000001 

Enhances screen display for applications that 
use the BIOS for screen output (as opposed to 
those that write directly to video memory). 

0x00000002 

Monitors output to video memory when 
application places VM in text mode. Slows 
direct video memory updates. 

0x00000004 

Monitors output to video memory when 
application places VM in low graphics mode. 
Slows direct video memory updates. 

0x00000008 

Monitors output to video memory when 
application places VM in high graphics mode. 
Slows direct video memory updates. 

0x00000080 

If application switches to less memory intensive 
video mode, excess memory is not freed. 


Add macros to your application easily and 
economically with Summit BasicScript 2.0. 


The BasicScript™ 2.0 Toolkit from Summit Software mokes it simple and affordable to odd on 
award-winning mocro language to your application by offering o complete set of DLLs, 
including Compiler, Runtime, Mocro Editor/Debugger, Diolog Editor, ond Mocro Recorder. 


B Easy-to-use APIs moke il simple to integrate Pie BasicScript DLLs into your application. 

B Support for OLE 2.0 Automotion allows your opplicotion to control objects in 
Microsoft Office ond other OLE 2.0 applications. 

B Compatibility with the syntax of Microsoft Visual Basic ond Visual Basic for 
Applicotions (V8A) reduces your customers' learning curve. 

B Extensibility architecture allows you to add your own objects, methods, properties, 
statements, functions, constants ond events to the BasicScript language. 

B Available for Windows, Windows NT, MS-DOS, SunOS, Solaris 2.x, HP/UX, AIX, Ultrix, 

Macintosh, NetWare ond OS/2. Compiled BasicScript code portoble between plotforms. 

B High-performance runtime con be redistributed by your customer without royalties. 

B End-user macro development tools (Macro Editor/Debugger, Dialog Editor ond Mocro Recorder) allow 
your Windows opplicotion to include on Integrated Development Environment (IDE) for macros. 

B Free technical support, comprehensive documentation, ond numerous code samples keep your 
engineering costs to a minimum. 

B Licensed by Symantec ond other leading software companies. Homed PC Magazine Editors' Choice 
among cross-application mocro languages. 

B Economicol licensing terms mean you don't have lo develop your own mocro longuoge. 
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PA S CAL or BASIC? 

Wish Your Software Was In 

C ? 


Then Don't Re-Invent the Wheel ! 

Automatically translate your code into readable 
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DOS VM. As far as I can tell, Microsoft does not document 
these flags either, even though the documented DDK 
function, VDD_PIF_State, requires a group of video state 


flags as a parameter. The first two members in the SEB 
are groups of flags derived from the PIF flags. Many of the 
flags share the same values as they do in the PIF file itself. 


Listing 2 createvm.c — Creating hidden VM via undocumented interface 



/* createvm.c */ 

/* Get Shell VxD's protect mode entry point. */ 

/* -- Application demonstrates using Shell VxD */ 

_asm mov ax, 1684h; 

/* protect mode API to create a hidden VM. */ 

asm mov bx, 0017h; 


asm int 2fh; 

♦include <windows.h> 

_asm mov word ptr [lpfn], di; 

♦include <mmsystem.h> 

asm mov word ptr [lpfn + 2], es; 

♦include "shell.h" 

if (NULL == lpfn) 


return 0; 

typedef DWORD (FAR * LPFNKvoid); 



/* Check version number. */ 

♦ifdef B0RLANDC 

asm mov dx, 0; 

♦pragma argsused 

if (0x030a > (*lpfn)0) 

♦endif 

return 0; 

int PASCAL WinMain(HINSTANCE hins, HINSTANCE hinsPrev.LPSTR lpsz. 


int wShow) 

/* Get path and working directory for DOS app. */ 

/★**★★*★****★★★★***★★★****★*★★**★*★★***★***•*:*****★****/ 

for (pch * szPath + GetModuleFileName(hins. 

/* -- Entry point. */ 

szPath, sizeof szPath) - 1; 

/****★★*★★★***★★*****★**★**★*★***★★★★*★*★**★**★*★***★*/ 

pch >= szPath; pch--) 

( 

if (*pch == '\V || *pch == ’:’) 

char szPath[128], szExe[128], szBuf[128]; 

( 

char *pch: 

*pch = 0; 

DWORD tim = timeGetTimeO; 

break: 

LPFN lpfn: 

1 

SEB seb; 

wsprintf(szExe. "XsWdosapp.exe", (LPSTR)szPath); 

DWORD hvm; 
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miscellaneous options. Table 1 summarizes those flags in 
the first group that I have discovered; there are probably 
others. 


especially those in the first SEB member. The flags in the 
first group specify how the DOS VM runs (exclusive, back¬ 
ground, and windowed), which sets of 'hot' keys are re¬ 
served for its use, various memory options, and some 


Listing 2 continued 

/* Initialize Shell Execute Data structure. */ 

asm mov dx, 3; 

seb.grfpif = fpifAltEnt 1 fpifAltPsc 1 fpifPrtSc I 

_asm push es; 

fpifCtlEsc I fpifAltTab i fpifAltEsc 1 

_asm push ss; 

fpifAltSp 1 fpifBack I fpifCloseE: 

asm pop es; 

seb.grfdis = 

(*lpfn)(); 

0x00000010 I fdisEmText I fdisNoText 1 fdisNoLow; 

asm pop es; 

seb.wfpExe.ib = (WORD)szExe; 

// Borland and Symantec accept 'db\ but Microsoft doesn't 

seb.wfpExe.sel = SELECTOROFC ( LPVOID)iseb); 

#if defined(_MSC_VER) 

seb.wfpArgs.ib = (WORD)”"; 

_asm _emit 66h; 

seb.wfpArgs.sel = seb.wfpExe.sel; 

#else 

seb.wfpWork.ib = (WORD)szPath; 

_asm db 66h; 

seb.wfpWork.sel = seb.wfpExe.sel; 

#endif 

seb.cpagWant = 0xffff; /* Use default. */ 

_asm mov WORD PTR hvm, ax; /* Really EAX. */ 

seb.cpagMin = 0xffff; /* Use default. */ 

if (0 != hvm) 

seb.wForePriority = 100; /* 0 to 10,000. */ 

{ 

seb.wBackPriority = 50; /* 0 to 10,000. */ 

wsprintf ( szBuf, "Created VM Xlx, elapsed time Xld", hvm, 

seb.ckbMaxEMS = 0x0400; 

timeGetTimeO - tim): 

seb.ckbMinEMS = 0x0000; 

MessageBoxtNULL, szBuf. "Hidden VM Demo". MB Ok); 

seb.ckbMaxXMS = 0x4000; 

) 

seb.ckbMinXMS = 0x0000; 

return 0; 

seb.wUnknownl = seb.wUnknown2 = 0; 

1 

lstrcpy(seb.szTitle, "Demo VM"); 

/* End of File */ 

/* Ask Shell to create the VM. */ 


_asm lea di, word ptr seb; 
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The second group of flags controls video options for 
the VM. When the virtual Shell device is creating the VM, 
it calls VDD_PIF_State with these flags. I don't understand 
what flag 0x00000010 is used for, but both WinOldAp and 
Visual C++ vl.5 always call function 3 with this flag set. 
The values that I do understand are summarized in Table 
2 . 

All string pointers passed to the virtual Shell device are 
passed as 48-bit far pointers (a 16-bit selector plus a 32- 
bit offset). I have declared the type WFP (Wide Far Pointer) 
in shell.h (Listine 1) to reDresent these values. The SEB 


Listing 3 dosapp.c — Dummy DOS program for 
demonstration 


/* dosapp.c */ 

/* — Silly little DOS app creates a file just to */ 
/* show that It ran. *1 

♦Include <std1o.h> 

void main(void) 

{ 

FILE *pfU ■ fopenC'dosapp.txt", Vt")s 
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presumably you should be able to use an arbitrary NULL- 
terminated string. 

The virtual Shell device's service routine for function 3 
is interesting. It first translates the three 48-bit far ad¬ 
dresses in the SEB into linear addresses and stores the 
results over the original 32-bit offsets. It then calls 
VDD_PIF_State with the video PIF flags and lastly calls the 
Virtual Machine Manager's (VMM) System_Control function 
with the Create_VM message. This causes the VMM to allo¬ 
cate a VM control block for the new VM, and to call the 
control procedure of each VxD in the system (by iterating 
over the VxD linked list) with the CreateJM message. As a 
result, control reenters the virtual Shell device. The shell 


processor's registers. You can get around this with a bit of 
inline assembly glue, specifically the operand size override 
prefix, to fetch the value out of EAX and into a DUORD. 

createvm.c (Listing 2) contains a demonstration program 
that uses the virtual Shell device's protected-mode API to 
create a hidden VM and to run a trivial DOS program 
from within it. dosapp.c (Listing 3) implements the DOS ap¬ 
plication, which does nothing more than create a file 
called dosapp. txt, into which it places the string 'This is a 
test", just enough to show that the application was actu¬ 
ally run. createvm.c obtains the address of the protected- 
mode callback, checks to see that it is version 310 (or 
higher), initializes a SEB, and calls the protected-mode 


device then performs further initialization of the VM, such 
as setting the time slice priority, allo¬ 
cating V86 pages for the VM, and 
setting the EMS and XMS limits. If 
none of the VxDS return failure (by 
setting the carry flag), then the VMM 
completes the creation of the new 
VM, and returns its handle to the vir¬ 
tual Shell device via the EBX register. 

The virtual Shell Device in turn re¬ 
turns the new VM handle to its client 
via the EAX register. This is a bit of a 
pain, since the client is generally exe¬ 
cuting 16-bit code, and does not 
have access to the high word of the 
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W/DDJ SDK Annotation #5 

2d 




Aligns a window or the byte boundary (in the x-direction) This flag should be set 
by applications that perform bitmap operations in windows by using the BitBIt 
function 


~~~~ 


n; 


Annotation: 


The documentation makes it sound like this style bit is the one 
you want foi efficient bitblts. In fact, most of your bitblts will be 
to the client area of the window, not the non-client area, so 
CS_BYTEALIGNCLIENT is the style bit you should set if you are 
concerned about bitblt operation efficiency. Unaligned windows 
are slower at VGA resolution, but not typically not an issue with 
higher resolution adapters (such as 256-color SVGA). 

Reference: p65, December 1993 Windows/DOS Developer’s 
Journal. 

(Add this annotation to your own online API help file by pressing 
Alt-E-A] 


Save 


Cancel 
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interface with function 3 to create 
the VM and run the DOSAPP pro¬ 
gram. 

createvm.c initializes the two flag- 
group members with the same val¬ 
ues used by Visual C++ vl .5 when it 
creates its hidden VM. Of particular 
importance is the dose-on-exit flag 
( fpifCloseL ), which instructs WIN386 
to destroy the VM when dosapp.exe 
terminates. 

createvm.c uses the special value 
of FFFFh for both the minimum and 
preferred VM memory fields; this 
causes the Shell device to use default 
values. In the current implementa¬ 
tion, the virtual Shell device uses 28@h 
for the desired size and 80h for the 
minimum. The code then goes on to 
set the foreground priority to the de¬ 
fault of 100 and the background to 
its default of 50. I picked the mini¬ 
mum and maximum values for the 
EMS and XMS values from those 
used by Visual C++ vl.5. Lastly, the 
two unknown 16-bit members are set 
to NULL, the title string is set to 'Demo 
VM,' and the virtual Shell device is 
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called to create the VM and run dosapp.exe. If all goes well, 
after you run createvm.exe there will be a file called dos- 
app.txt in the same directory as createvm.exe. 

Why even bother to go to all the trouble of using the 
virtual Shell device to create a hidden VM? After all, it is 
possible to UinExecO the DOS program to run, specifying 
SU_HIDE for the wShow parameter. The result is a DOS VM, 
but with a hidden window. Such a DOS box does not 
show up in the Task Manager's task list, nor can it be 
switched to using the keyboard or mouse. 

I can think of a couple of reasons. The first is speed. 
On my machine, it takes approximately 1200ms to regain 
control after creating a hidden DOS VM using UinExecO 
(1700ms the first time), but only 20ms using the virtual 
Shell device. The other reason is better control. Using the 
virtual Shell device, the calling program can specify lots of 
parameters to control the VM's execution. The only way 
to get this control with UinExecO is to execute a .pf f file. 
This means you are restricted to executing a pre-existing 
file, or must first create one on the fly. Not only is using a 
file to communicate VM parameters slow and clunky, but 


the .p/Yfile format is also undocumented. If your options 
for controlling the VM's execution are a slow, clunky, un¬ 
documented interface and a fast, programmatic, undocu¬ 
mented one, the choice seems clear. 

The ability to create hidden VMs actually unleashes a 
lot of the power of WIN386. VMs are preemptively multi- 
tasked with one another. Couple this with the fact that 
Windows provides a DPMI implementation which allows a 
real-mode DOS application to switch itself into protected 
mode, and all of a sudden you are exploiting a very pow¬ 
erful true multitasking operating system. In fact, you 
should even be able to alter the 'D' bit of the protected- 
mode code segment descriptors to switch whatever pro¬ 
gram is being run in the VM into 32-bit mode. 

All of this discussion is really only scratching the sur¬ 
face, since there are 15 other functions provided by the 
virtual Shell device. You can find out more on this subject 
in both an upcoming installment of Andrew Schulman's 
'Undocumented Corner' and a new book he is working 
on, to be called Unauthorized Windows. □ 
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Binding Data to Dialog Controls 

William Smith 


;E3 


Borland C++ v4.0 
Symantec C++ v6.1 
Visual C++ vl.5 



If you look at many different dialog box procedures you will see a lot 
of similarity in the tasks they carry out and the code that performs these 
tasks. The recurring patterns center on the need to initialize controls with 
values and then retrieve the current values from controls when the user 
closes the dialog box. 

The UM_INITDIALOG message triggers initialization. The code that re¬ 
sponds to this message typically has to initialize various controls, check¬ 
ing checkboxes or pushing radio buttons, setting default selections in 
listboxes, and so on, on the basis of some data structure that roughly 
corresponds to the data that the dialog box gathers. Likewise, the code 
that responds to the UM_COMMAND message when the user selects the 'OK' 
pushbutton typically contains function calls that inspect checkboxes, ra¬ 
dio buttons, listbox selections, and so on, copying salient information to a 
data structure that gets returned to the caller that invoked the dialog box. 

Each different dialog box has a collection of different controls and 
slightly different needs for initialization and final value retrieval. This 
makes it nearly impossible to identify shareable common code between 
dialog box procedures. What Windows needs is a way to associ¬ 
ate or bind data to a dialog control. This would allow the con¬ 
trol to initialize itself and copy user input into a data area that 
the program uses. 

Data Binding 

My scheme for binding dialog box controls to data involves 
two parts. First, for each standard Windows control (or even 
third-party custom control), I create a corresponding custom 
control that is just a subclass of the standard control. This new 
custom control defines a new window message for binding: you 
pass the address of the data that the control should be bound 
to. Second, I create a dialog window class whose window proce¬ 
dure can handle the chores of initializing all the controls in the 
dialog. The dialog controls get initialized via the corresponding 
data in your program; when the dialog shuts down, the controls 
automatically update the data with any changes that the user 
made (such as checking a box or entering data in an edit field). 

I bound the data pointer to the instance of the corresponding 
control by using window extra bytes. You could just as easily use 
window properties. Using window extra bytes requires you to cre¬ 
ate a new window class. If you used window properties, you could 
avoid creating new window classes, but would have to subclass each 
control at runtime. This would add complexity and redundant code, both 
of which are overhead that I was trying to eliminate. Subclassing at run¬ 
time could also necessitate a dialog box procedure for each dialog box. 

William Smith is the engineering manager at Montana Software, a software 
development company specializing in custom applications for MS-DOS and 
Windows. You may contact him by mail at P.O. Box 663, Bozeman, MT 59771- 
0663. 
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Listing 1 Source for data binding controls 


/***************************************************** 

Name: 

BINDCTLS.C. Listing 1 
File Type: 

Library 

Description: 

Library of functions for supporting data binding 
to controls. 

Function List: 

BindCtlData 
CtlProcBindButton 
CtlProcBindDialog 
CtlProcBindEdit 
RegisterBindButton 
RegisterBindDialog 
RegisterBindEdit 
Portability: 

MS Windows 

/* MS Windows */ 

#include <windows.h> 

/* Own */ 

#include "bindctls.h" 

static WNDPROC _CtlProcButton; 
static WNDPROC _CtlProcEdit; 

LRESULT BindCtlData( HWND hWnd, LPARAM 1Param ) 
t 

int i; 

LPBINDCTLDATA lpData = (LPBINDCTLDATA)1Param; 


The bottom line is that, to make a control easy to use, 
even if it is a subclass, you must implement it as a new 
window class. A new window class has the added advan¬ 
tage of allowing the control to be stored in a dynamic link 
library (DLL) and interfaced to a resource editor. 

Implementation 

bindctls.c (Listing 1) contains code for two custom con¬ 
trols and one custom dialog class. These are simplified 
versions of the ones I use in my own application develop¬ 
ment. The custom controls are subclasses of the standard 
'Button' and 'Edit' window classes. I call these new con¬ 
trol classes 'BINDBUTTON' and 'BINDEDIT', respectively. 
The window callback procedure names are CtlProcBindBut- 
ton() and CtlProcBindEditO. 

I have used data binding techniques for the standard 
'Listbox', 'Combobox', and other third-party custom con¬ 
trols. I've chosen to present the 'Button' and 'Edit' con¬ 
trols because they are simple and illustrate the concept of 
data binding rather clearly. 

bindctls.h (Listing 2) contains function prototypes for 
the public functions in bindctls.c. bindctls.h also defines 
some constants used by the bind controls, such as the 
constants for the window extra byte offset to the data 
pointer and a new window message, bindctls.h (Listing 2) 
defines a type called BINDCTLDATA. This structure associates 
a control ID with a long data pointer. This type makes it 
easy to associate data addresses with control IDs. You can 
pass an array of BINDCTLDATA types as the initialization 
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parameter in the functions DialogBoxParamO and DialogBox- 
IndirectParamO. 

Besides the custom controls, bindctls.c (Listing 1) con¬ 
tains the code for a custom dialog window procedure. The 
new window class name is 'BINDDIALOG' and the call¬ 
back procedure is UndProcBindDialogO. The 'BINDDIALOG' 
class provides a way to use the custom controls without a 
dialog box procedure. You can use the controls in con¬ 
junction with a dialog box procedure, but you do not 
need to. 

If your dialog box is simple and its functionality is lim¬ 
ited to data display and data entry, then you can just use 
the 'BINDDIALOG' class instead of supplying your own 
dialog box procedure. Most dialog box procedures are by 
nature similar and contain redundant code. Using the cus¬ 
tom dialog class, 'BINDDIALOG', in cooperation with the 
custom controls that support data binding affords a way 
to eliminate the dialog box procedure. 

Custom Data Binding Controls 

The first requirement of data binding is to add the fea¬ 
tures of initialization and data extraction to the window 
procedure of a control, bindctls.c contains the window 
procedure for the 'BiNDBUTTON' control, CtlProcBindBut- 
ton(). Notice that it responds to three messages, 
UM_USER_BINDDATA, HMJILLFOCUS, and UM_SETCHECK. The mes¬ 
sage UM_USER_BINDDATA is a user-defined message that 
tells the control to store a pointer to a data area. 
UM_USER_BINDDATA also triggers the control to initialize its 


Listing 1 continued 


for ( i = 0; 1pDatafi].1pData; i++ ) 

{ 


SendDlgltemMessaget hWnd. 1pData[i].iCtlId, WM_USER_BINDDATA, 
0 . 1 pData[i].1pData ); 


} 


return ( 0L ); 


} /* function BindCtlData */ 


IRESULT CALLBACK_export CtlProcBindButton( HWND hWnd, 

UINT uiMsg, WPARAM wParam, LPARAM IParam ) 

{ 

if ( uiMsg == WM_USER_BINDDATA ) 

{ 

SetWindowLongi hWnd, GWL_BINDBUTTON. IParam ); 
if ( IParam ) 

{ 

SendMessageC hWnd, BM_$ETCHECK, (WPARAM) 

*( (int FAR *)1 Pa ram ), 01 ); 

} 

return ( 0L ); 

) /* if ( uiMsg == WM_USER_BINDDATA ) */ 

if ( uiMsg == WM_KILLFOCUS ) 

{ 

int FAR *p = (int FAR *)GetWindowLong( hWnd, 
GWL_BINDBUTTON ); 
if ( p ) 
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Listing 1 continued 


{ 

*p = (int)SendMessage( hWnd, 

BM_GETCHECK, 0, 0L ); 

} 

} /* if ( uiMsg == WM_KILLFOCUS ) */ 

else if ( uiMsg == BM_SETCHECK ) 

{ 

int FAR *p = (int FAR *)GetWindowLongf hWnd, 
GWLJINDBUTTON ); 
if ( p ) 

( 

*p = (int)wParam; 

} 

} /* else if ( uiMsg == BM.SETCHECK ) */ 

return ( CallWindowProct _CtlProcButton, hWnd, 
uiMsg, wParam, IParam )); 

} /* function CtlProcBindButton */ 


LRESULT CALLBACK _export Ctl ProcBi ndEditC HWND hWnd, 
UINT uiMsg, WPARAM wParam, LPARAM IParam ) 

( 

if ( uiMsg == WM_USER_BINDDATA ) 

{ 

SetWindowLongi hWnd, GWL_BINDEDIT, IParam ); 
if ( IParam ) 

{ 

SetWindowTexti hWnd, (LPSTR)lParam ); 

} 


value to that data. This is the data binding and initializa¬ 
tion step. 

The other messages trigger data extraction chores. In 
response to the UM_KILLF0CIIS and the UM_SETCHECK mes¬ 
sages, the control sets the value of the bound data to the 
current state of the control. This ensures that the bound 
data will be kept current with the state of the control, so 
that the bound data will be accurate when the user closes 
the dialog box. The other control in bindctls.c (Listing 1) is 
the 'BINDEDIT' control, and its window procedure re¬ 
sponds to the same three messages. 

Besides the standard initialization and data retrieval, 
you may want a smart data binding control to respond to 
another situation. This would be where the data to which 
the control is bound is changing from outside the control 
and the control needs to update its visual copy of the 
data. You could add this functionality by setting up a Win¬ 
dows timer - the control would update the display in re¬ 
sponse to the timer message. Another possibility is to up¬ 
date the display from the data in response to the UM_PAINT 
message. A situation where this may be needed is an ap¬ 
plication that is monitoring a constantly changing value, 
such as instrumentation. 

The Custom Dialog Class 

Each Windows window is based on a window class. A 
dialog box is a window, and it is based on a predefined 
internal Windows class, '#32770'. However, you can spec¬ 
ify your own window class when you define a dialog box; 
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in that case, the dialog box will be created from the win¬ 
dow class you name rather than the default dialog win¬ 
dow class. 

Dialog boxes of the default class use a default window 
procedure called DefDlgProcO for their message processing. 


If there is a dialog procedure for the dialog box, 
DefDlgProcO calls it. Depending upon the dialog box pro¬ 
cedure's return value, DefDlgProcO either continues with 
default processing or considers the processing completed 
by the dialog box procedure. 


Listing 1 continued 


wc.hCursor = LoadCursort NULL, IDC ARROW ); 

return { 0L ); 

wc.hbrBackground = ( HBRUSH )( C0L0R_WINDOW + 1); 
wc.lpszMenuName = NULL; 

} /* If ( uiMsg == WM_USER_BINDDATA ) */ 

wc.lpszClassName = "BINDDIALOG”; 

if ( uiMsg == WM KILLFOCUS ) 

{ 

return ( RegisterClass( iwc )); 

} /* RegisterBindDialog */ 

LPSTR lpstr = (LPSTR)GetWindowLongC hWnd, GWLJINDEDIT ); 

if ( lpstr ) 

{ 

GetWindowTextt hWnd, lpstr, -1 ); 

BOOL RegisterBindEditt HINSTANCE hlnstance ) 

{ 

} 

WNDCLASS wc; 

} /* if ( uiMsg == WM_KILLFOCUS ) */ 

GetClassInfot NULL, "EDIT", iwc ); 

else if ( uiMsg == WM SETTEXT ) 

_CtlProcEdit = wc.lpfnWndProc; 

{ 

wc.lpfnWndProc = CtlProcBindEdit; 
wc.hlnstance = hlnstance; 

LRESULT 1 Result = CallWindowProct CtlProcEdit. hWnd, uiMsg, 

wc.lpszClassName * "BINDEDIT"; 

wParam, IParam ); 

wc.cbWndExtra += sizeof ( void FAR *); 

LPSTR lpstr = ( LPSTRIGetWindowLongt hWnd,GWLJINDEDIT ); 

return ( RegisterClasst Iwc )); 

if ( lpstr ) 


{ 

GetWindowTextt hWnd, lpstr, -1 ); 

} 

} /* RegisterBindEdit */ 

LRESULT CALLBACK _export WndProcBi ndDi al og( HWND hWnd, 

return ( 1 Result ); 

UINT uiMsg, WPARAM wParam. LPARAM IParam ) 

{ 

} /* else if ( uiMsg == WM SETTEXT ) */ 


LRESULT 1 Result; 

return ( CallWindowProct _CtlProcEdit, hWnd, uiMsg, wParam, IParam )); 

if ( uiMsg == WM INITDIALOG ii IParam ) 

{ 

BindCtlDatat hWnd, IParam ); 

} 

} /* function CtlProcBindEdit */ 

BOOL RegisterBindButtont HINSTANCE hlnstance ) 

if ( GetWindowLongt hWnd, DWL DLGPROC ) == 

{ 

(LONG)WndProcBindDialog ) 

{ 

SetWindowLongt hWnd, DWL DLGPROC, 0L ); 

} 

WNDCLASS wc; 

GetClassInfot NULL, "BUTTON", iwc ); 

_CtlProcButton = wc.lpfnWndProc; 

1 Result = DefDlgProct hWnd, uiMsg, wParam, IParam ); 

wc.lpfnWndProc = CtlProcBindButton : 
wc.hlnstance = hlnstance; 

if ( uiMsg == WM COMMAND ii IsWindowt hWnd ) ii 

wc.lpszClassName = "BINDBUTTON": 

( wParam == IDOK II wParam == IDCANCEL )) 

wc.cbWndExtra += 1 + sizeof ( void FAR *); 

{ 

if ( GetFocust) 1= GetDlgltemt hWnd, wParam )) 

return ( RegisterClasst Iwc )); 

( 

SetFocus ( GetDlgltemt hWnd, wParam )); 

} /* RegisterBindEdit */ 

} 

EndDialogt hWnd, 


( wParam == IDOK ? TRUE : FALSE )); 

BOOL RegisterBindDialog( HINSTANCE hlnstance ) 

{ 

} 

return ( 1 Result ); 

WNDCLASS wc; 

} /* function WndProcBindDialog */ 

wc.style = 0; 

wc.lpfnWndProc = WndProcBindDialog; 

wc.cbClsExtra = 0; 

wc.cbWndExtra = DLGWINDOWEXTRA: 

wc.hlnstance * hlnstance; 

wc.hlcon = NULL; 

/* End of BINDCTLS.C */ 
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Listing 2 Interface to data binding code 


/★A*************************************************** 

Name: 

BINDCTLS.H, Listing 2 
File Type: 

Include 

Description: 

Include for for BINDCTLS.C 
Portability: 

MS Windows 

*****************************************************/ 

#if !defined ( BINDCTLS_DEFINED ) 

#define BINDCTLS_DEFINED 

/* Bind data information structure */ 
typedef struct tagBINDCTLDATA 
{ 

int iCtlld; 

LPARAM lpData; 

} BINDCTLDATA, FAR *LPBINDCTLDATA; 

/* Wnd Extra byte offset for BINDEDIT data pntr */ 

#defi ne GWLJINDEDIT 6 

/* Wnd Extra byte offset for BINDBUTTON data pntr */ 
#define GWLJINDBUTTON 4 

/* message for BINDEDIT and BINDBUTTON controls */ 
#define WM_USER_BINDDATA ( WM_USER + 1000 ) 

/* Prototypes of functions in BINDCTLS.C */ 

LRESULT BindCtlDatat HWND hWnd, LPARAM IParam ): 
LRESULT CALLBACK CtlProcBindButtonC HWND hWnd, 

UINT ulMsg, WPARAM wParam, LPARAM IParam ); 
LRESULT CALLBACK CtlProcBindEdit( HWND hWnd, 

UINT uiMsg, WPARAM wParam, LPARAM IParam ); 

BOOL RegisterBindButtonC HINSTANCE hlnstance ); 

BOOL RegisterBindDialog( HINSTANCE hlnstance ): 

BOOL RegisterBindEdit( HINSTANCE hlnstance ); 

LRESULT CALLBACK WndProcBindDia 1og( HWND hWnd, 

UINT uiMsg, WPARAM wParam. LPARAM IParam ); 

#end1f /* #1f Idefined ( BINDCTLSJEFINED ) */ 

/* End of BINDCTLS.H */ 



Figure 1 Sample dialog box with data binding 


It may seem a bit confusing, but a dialog procedure 
and a window procedure are different. A dialog box pro¬ 
cedure is called by the window procedure for the dialog 
class. Adding even more confusion to this is the concept 
of custom dialog classes. The window procedure for a cus¬ 
tom dialog class first receives messages, then passes them 
on to the default dialog window procedure, which passes 
them on to the dialog procedure. 

Using a custom dialog box window class, such as 
'BINDDIALOG', with the custom bind controls offers a cou¬ 
ple of advantages. The first is that it will trigger the initiali¬ 
zation step automatically. In response to the WMJNITDIALOG 
message, the window procedure for the 'BINDDIALOG' 
class, WndProcBindDialogO, calls the function BindCtlDataO, 
passing its window handle and IParam parameter. If you 
invoked the dialog box with DialogBoxParamO or DialogBox- 
IndirectParamO, IParam is the value that you passed as the 
initialization value. BindCtlDataO assumes that this is an 
array of BINDCTLDATA structures. BindCtlDataO loops through 
these structures, sending WMJSER_BINDDATA messages to 
each control In the array. BindCtlDataO stops this process 
when it encounters a BINDCTLDATA structure with a NULL data 
address. If you want a control not to have an address 
bound to it, just leave it out of the array of BINDCTLDATA 
structures. 

Using the custom BINDDIALOG class with a dialog box 
gives you the option of not using a dialog box procedure 
with a dialog box. Unfortunately, not specifying a dialog 
box procedure (fourth parameter) in either DialogBoxParamO 
or DialogBoxIndirectParamO results in Windows not sending 
a WMJNITDIALOG message. The WMJNITDIALOG message is im¬ 
portant because it facilitates passing a value to the dialog 
box using the functions DialogBoxParamO or DialogBoxIndi¬ 
rectParamO. Data binding without a dialog box procedure 
still requires the WMJNITDIALOG message. 

The fact that Windows does not send a WMJNITDIALOG 
message when there is no dialog box procedure is an an¬ 
noying bug. To force Windows to send the WMJNITDIALOG 
message when you are not going to use a dialog box 
procedure, you must pass the custom dialog box window 
procedure as the dialog box procedure. Normally this 
would cause a circular (recursive) message loop and a 
stack overflow. WndProcBindDialogO checks for this situation 
and sets the dialog box procedure to NULL, as follows. 

if ( GetWindowLongt hWnd, DWLJLGPROC ) 

== (LONG)WndProcBindDialog ) 

SetWindowLong( hWnd, DWL_DLGPROC. 0L ); 

With this fix in place, you can use the 'BINDDIALOG' class 
with a dialog box whether or not the dialog box has a 
dialog box procedure. In either case it will initialize the 
'BINDBUTTON' and 'BINDEDIT' controls in the dialog box. 

The 'BINDDIALOG' class also fixes another Windows 
inconsistency - or bug - that surfaces when the dialog 
box is closed. The bind controls need a message to tell 
them when to retrieve user-entered values into the bound 
data. The WMJILLFOCUS message is a convenient opportu¬ 
nity to do this. Unfortunately, a control does not always 
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receive this message, even when it loses the input focus. 
When a user closes a dialog box by using the Enter key to 
select the default pushbutton, Windows does not change 
the focus to the default pushbutton. This is a different 
case than selecting the default pushbutton with the mouse 
or hitting the space bar when the button has the focus. 
The custom dialog class, 'BINDDIALOG', provides a fix in the 
case where the user closes the dialog box by hitting the En¬ 
ter key. UndProcBindDialogO checks to see if the selected con¬ 
trol has the input focus; if not, it gives the control the input 
focus by calling SetFocusO. UndProcBindDialogO does this by 
monitoring the UM_COMMAND message and checking to see if the 
selected control is either the 'OK' or 'Cancel' pushbutton. If 
so, and if the pushbutton does not have the focus, 
UndProcBindDialogO calls SetFocusO to 
give the pushbutton the focus. 

This fix assumes that the dialog 
box has only two different pushbut¬ 
tons, with control IDs IDOK and IDCAN- 
CEL, that can close the dialog box. If 
you need an Exit or Abort or some 
other pushbutton that can close the 
dialog box, you will have to modify 
UndProcBindDialogO accordingly. 

Sample Application 

The code disk contains a small ap¬ 
plication that demonstrates the con¬ 
cept of data binding to controls. The 
demonstration program uses the cus¬ 
tom button and edit controls, as well 
as the custom dialog window class in 
bindctls.c (Listing 1). The demonstra¬ 
tion program brings up a dialog box 
(see Figure 1) but does not have a 
dialog box procedure for the dialog 
box. Instead, it uses the 'BINDDIA¬ 
LOG' window class. 

The demonstration program first 
sets up an array of BINDCTLDATA struc¬ 
tures to pass when creating the dia¬ 
log. Note that before calling Dialog- 
BoxParamO, the demonstration pro¬ 
gram registers the 'BINDBUTTON', 

'BINDEDIT', and 'BINDDIALOG' win¬ 
dow classes. The functions Register- 
BindButtonO, RegisterBindEditO, and 
RegisterBindDialogO in bindctls.c ac¬ 
complish this chore. If you decide to 
use these controls in more than one 
application, I recommend that you 
put bindctls.c in a DLL and execute 
all the registration tasks from within 
the DLL's startup function, LibMainO. 

Conclusions 

By its nature Windows code tends 
to be very redundant. Each window 
procedure and dialog procedure has 


strong similarities with others. One way to eliminate re¬ 
dundant initialization and clean-up code between dialog 
boxes is to move that code into the window procedure of 
the control, where more than one dialog box can share it. 

Moving code into a control's window procedure makes 
the control smarter. The control can take care of itself, 
performing both initialization of data and data clean up. If 
a control is to initialize itself and retrieve its value into a 
usable data area, the control must know where to retrieve 
and store information. This requirement is satisfied by the 
concept of data binding. Binding data to a control is as 
simple as storing a pointer (data address) in the window 
extra bytes. Using a custom dialog class can even help 
simplify the data binding chores. □ 
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-lint 


for C/C++ 

presents Bug # 606 


#include <iostream.h> 
#include <string.h> 

int main() 

{ 

int n; 

char escape[2]; 
n = 3; 

strcpy( escape, "\X1B" ); 
cout << n; 
return 0; 

} 


This program should print 3. However on some compilers it prints something 
quite different. What is the fatal flaw? Call if you need a hint. Refer to Bug #606. 


PC-lint for C/C++ will catch this and many 
other bugs. It will analyze a mixed suite of C 
and C++ modules to uncover bugs, glitches, 
quirks and inconsistencies. 

Numerous C++Warnings and Messages: 
Are your inherited destructors virtual? Are 
your constructor new's matched by your 
destmctor delete’s? Are your initializers 
in order? Are names inadvertently hiding 
other names? Are your C++ modules 
consistent with your C modules? Much, 
much. more. 

Plus Our Traditional C Warnings: 

Uninitialized variables, unaccessed variables, 
possibly uninitialized variables, strong type 
mismatches, indentation irregularities, loss of 
precision, strange uses of Booleans. 
signed/unsigned mismatches, suspicious 
expressions, unused macros, etc. etc. 


Full C++ Support - PC-lint for C/C++ 
is based on the ARM and is tracking the 
latest ANSI/ISO draft including exceptions 
and templates. It supports both Borland and 
Microsoft C/C++. 

Options Galore: A plethora of options for 
message suppression, message format, 
compiler dependencies, etc. All messages 
can be individually suppressed or enabled, 
both locally and globally. Numerous 
compilers/ libraries supported. Runs on 
MS-DOS (Optional built-in 386 DOS 
extender) and OS/2. 

PC-lint for C $139 
PC-lint for C/C++ $239 

PC-lint users: call for update pricing 
Unix and Mainframe programmers: 

call for pricing for FlexeLint. 


PA add 69c sales tax. 


Gimpel Software 

3207 Hogarth Lane, Collegeville, PA 19426 

CALL TODAY (610)584-4261 Or FAX (610)584-4266 

30 Day Money-back Guarantee. 

PC-lint and FlexeLint are trademarks of Gimpel Software 
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C CODE FOR THE PC 

source code, of course 

Graphic 7.0 (high-resolution, scientific plots in color & hardcopy, contour plots, device independence).$370 

TE Editor Developer’s Kit for Windows V 4.0 (full screen editor, undo command, word processing; TER for application build-in; no royalties) $300 
C/C+ + Libraries by Code Farms (persistent C structures, ER models, dynamic arrays, database functions, Jolt Award winner; specify C or C++)$260 
Victor Image Processing Library V3.1 (brightness, contrast, merge images, TIFF/GIF/PCX; color reduction source $395; Windows $550) . . $250 

TUrboTrff (Release 3.1; HP, PS, dot drivers; CM fonts; LaTgJC; MetaFont).$250 

Crusher! V2.00 (platform-independent data compression for network transfer; beats PK & LH on binary; directory trees; portable C) . . . . $215 

TE Editor Developer’s Kit V3.0 (full screen editor, undo command, multiple windows; V3.5 with Word Processing $280).$190 

COMM-DRV Version 14 (complete interrupt-driven serial communication libraries & device drivers; full source).$155 

Minix Operating System (Version 1.5; Unix-like operating system, includes manual; specify 5.25” or 3.5” diskettes).$150 

Delorie GCC for MS-DOS (Version 2.Z2; includes C++, assembler, DOS extender, 387 emulation; complete source code and makefiles) . . $150 
Moby Crypto II (PGP, DES, Secure Hash, UFC, MDs, Crack 4.1, Lucifer, IDEA, VCR+, large integer packs, tutorials, more; not for export) . $150 
Lisp for DOS (Kyoto Common Lisp and CLISP; KCL includes Lisp-to-C translator for building mixed Lisp/C programs, two big manuals) . . $140 

Ibrow (Version 4.1; programmer’s Windows-based editor; large files, help, undo/redo, drag-n-drop, function & type tags).$135 

NEW! NetBIOS Engine V2.03 (shared DDL, post-prooessing, notification via messages, complete docs, control panel, no royalties).$125 

Cheaper! XASM (cross assemblers & utility programs; 65xx, 68xx, 80xx; Intel or Motorola hex format; macro preprocessor).$125 

NEW! OSF/Motif 1.2.3 (port of Metrolink OSF/Motif to Linux; single CPU license).$105 

SCM (portable Scheme in C, IEEE standard, includes JACAL symbolic math package; SCM-4D0/SLIB-1D5/JACAL-1A3) .$100 

PC/IP (CMU/MIT TCP/IP for PCs; Ciynwr drivers, NFS server, Bdale mailer, PCRoute/PCBridge, NDIS/ODI drivers, Beholder, more) . . . $100 

Updated! DA (disassembler for Microsoft’s New Executable (NE) binary files including Windows .exe, .drv, .dll, and .fit).$95 

Script Interpreter (a command script interpreter for DOS-based systems; C-Rke script language; lots of features).$90 

CELT 3.2c (Federal Standard 1016 Code Excited Linear Predictive voice sampling and encoding; voice over 4.8kbps; Unix code).$80 

CPPCOMM V3.0m (C+ + serial communications class library for DOS, Windows, OS/2, and NT; includes X/Y/Zmodem).$75 

ET NeuroKit V3.1 (back error propagation and Kohonen).$75 

Kier DateLib (all kinds of date manipulation; translation, validation, formatting, & arithmetic).$60 

Coder’s Prolog (Version 3.0; inference engine for use with C programs).$60 

PCCTS Version 1.10 (Purdue Compiler Construction Tool Set; like YACC and LEX together with lots of additional features).$60 

Container Lite V1.87 (C+ + & FLC wrapper emulators; portable, persistent containers of arbitrary data including pointers).$50 

BigFloat (arbitrary precision floating point arithmetic and functions; includes BCD conversion).$50 

EZCalc (ASCII algebraic expression evaluator, unlimited parenthesis nesting, symbols, 32 built-in functions, easily extended).$50 

Backup & Restore Utility by Blake McBride (multiple volumes, file compression & encryption).$50 

CLIPS Version 6.0 (rule-based expert system generator; Windows compatible; manuals on disk).$50 

SuperGrep (exceptionally fast, revolutionary text searching algorithm; also searches sub-directories).$50 

OBJASM (convert .obj files to .asm files; output is MASM compatible) .$50 

Editor Pad: (20 public domain editors; micromacs 3.12, Stevie, Elvis, Moke, mg2a, DTE, Jove, Origami, CE & GRIEF).$50 

Exceptions for C (Ada-like exception handling for C programs; exceptions for any block; exceptions can be reraised).$45 

DES Encryption & Decryption (2500 bits/second on 4.77 MHz PC for on-the-fly encryption at 2400 baud; not for export).$40 

Database Pack (9 databases - simple to complex; DOS: isam, bplus, AVL, SDB, ID, gabm; Unix: Requiem, Ingres89, Postgres).$35 

COP (poor man’s C++; C macro package which implements C++ in C) .$35 

OCT (Object C Translator; essentially Brad Cox’s Objective-C Version 4).$35 

RXC & EGREP Version 2.0 (Regular Expression Compiler and Pattern Matching; finite state machine from regular expression).$35 

Bison & BYACC (YACC workalike parser generators; documentation; includes C and C++ grammars) .$35 

Spell Pack (6 spelling programs, a hyphenator, 2 utility packs and a 60K word list: Ispell, Microsp, Sp, Cspella, Spell, Dawg, Soundex) .... $30 

REGX Plus V3.1 (search and replace string manipulation routines based on compiled regular expressions).$30 

GNU Awk & Diflf for PC (both programs in one package).$30 

Big Number Pack (7 arbitrary precision arithmetre packages in C, one in Fortran but free Fortran-to-C converter is included) .$30 

Crunch Pack (30 file compression & expansion programs; now includes portable ZIP).$30 

NEW! OORT (C++ ray tracing code from the book by Nrcholas Wilt) .$30 

OEmacs (full GNU Emacs for DOS and Windows DOS box; C+ + support, etags++, lots of .el files) .$25 

NEW! CT*k Version 2.22d (robust MS-DOS multitasking kernel; C functions run as light-weight processes; mailboxes, interrupts, pipes, etc.) . . . $25 

PERL for MS-DOS (Version 4.019; C, sed, awk, and shell all rolled into one language; includes hardcopy docs).$25 

FLEX Version 2.4.3 (fast lexical analyzer generator; new, improved LEX).$25 

GNU RCS (FSFs version of the Revision Control System; like Unix’s SCCS only better; keeps track of software development).$20 

Data 

Moby Thesaurus II (6,000 root words, 2.5M synonyms, ’’common sense”, concept related searches) .$500 

NEW! Wintertree Build-in Sentry Spell-Checker Library and ThesDB Thesaurus libra ry(C/C+ + API, no royalties, powerful).each $450 

Moby Pronundator II (175,000 words & phrases encoded with full IPA pronunciation & emphasis points).$265 

Moby Part-of-Speech II (230,000 words and phrases described by prioritized part(s)-of-speech).$170 

Moby Hyphenator II (185,000 words fully hyphenated/syllabified).$105 

Moby Words II (610,000 words & phrases with Scrabble(tm) word list, place names, baby names, acronyms, core list for spell checkers) . . . $100 

NEW! Linux Bible (Everything you ever wanted to know aboutLinux, 700+ page book).$40 

CIA World Bank II Database (13MB of maps, 5.7M vectors; coastlines, rivers, political boundaries; 5.25” HD only).$35 

U. S. Cities (names & longitude/latitude of 32,000 U.S. cities and 6,000 state boundary points).$35 

The World Digitized (100,000 longitude/latitude of world country boundaries) .$30 

CD-ROMs 

BSD/386 (POSIX-compatible O/S; complete development package, full networking, kernel debugger, X11R5, DOS box; complete source code) $900 

AI CD-ROM (expert systems, neural networks, genetic algorithms, fuzzy logic, Iinguistics/naturalTanguage).$105 

OmniMap (street-level US mapping; lots of topographical features, Windows viewer, output to many file formats).$75 

Prime Time for Unix (Volume 3, No. 1, January, 1994; over 6GB of Unix C code).$60 

Whlnut Creek Libris Britannia (over 600MB of the best of British boards; not all source included).$50 

Whlnut Creek C User’s Group (Volumes 100 to 364).$40 

Updated! Linux/GNU/X by Yggdrasil Computing Version 1.1 (run from the CD; TCP/IP & NFS; drivers; MPEG; SCSI support; lots more).$35 

Mailer’s Lookup (9-digit ZIP codes by street address, distances between ZIP codes, phone locations; on-line tool, no source code).$35 

Knowledge Media Multimedia (625MB & 13,000 files; 1,232 sounds, 179 books, 100 movies, 114 stacks, 606 programs, 214 mods) .$35 

Project Gutenberg (literature, historical documents, reference books, census data, religious documents, math constants, etc.) .$35 

Updated! Knowledge Media Languages & Operating Systems (640MB of compilers, libraries, and operating systems; source code & executables) . . . $35 

Updated! Walnut Creek X11R6 and GNU (XI1R6 with contributed and comp.sourcesx, over 120 GNU programs, complete C source).$35 

Wilnut Creek Usenet and Simtel Unix-C (600MB).$35 

Walnut Creek Giga Games (arcade, simulations, card games, education, trivai, cheat sheets; some source).$35 

Austin Code Worics Internet Warrior #1 (PC Internet tools: Gopher, Wais, Eudora, ph, Nupop, Thimpet, TCP/IP, FAQs, drivers, docs) . . . $35 

NEW! Walnut Creek FreeBSD (Berkeley 32-bit operating system for PCs; bootable).$35 

Walnut Creek Tbolkit for Linux (Slackware distrubtion and complete Linux archive).$35 

NEW! Hans-Ameritech Slackware Linux (automated installation, lots of applications, extra kernels, Kanji, docs, FreeBSD).each $30 

NEW! Hacers and Tracings #1 (400 programs for raytracing, 850 images, 180 animations, fully-indexed, 489MB, July 1994).each $25 

Cheaper! Knowledge Media MegaMedia I and II (images, sounds, movies).each $25 

InfoMagic CICA Windows Archive (2 CD set, complete archive).$25 

InfoMagic Simtel 20 MSDOS Archive (2 CD set, source code but lots of other stuff too).$25 

NE W! InfoMagic Linux (2 CD set; complete source code from two Internet Linux sites; lots of contributed software).$20 

The Austin Code Works much more ... ask for catalog Voice: (512) 258-0785 

11100 Leafuiood Lane FAX: (512) 258-1342 

Austin, Texas 78750-3587 USA http://www.clark.net/acw/home.html E-mail: info@acw.com 

Free surface shipping for cash in advance For delivery in Texas add 7% MasterCard/VISA/AMEX 
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Object-Oriented Programming 




A String-Oriented Client 
DDE Class 

Ron Burk 


e03= 

Borland C++ v4.0 

; Symantec C++ v6.l 


Visual C++ vl ,5 


Recent Symantec C++ advertisements suggest that Borland's Windows class 
library (OWL) is 'proprietary' but that Microsoft's Windows class library (MFC, 
which Symantec licenses from Microsoft to bundle with Symantec C++) is not. 
The distinction escapes me - any class library that I have to purchase a 
compiler to obtain seems pretty proprietary to me. It's not as though we can 
expect to see third-party implementations of OWL or MFC appearing anytime 
soon. Using Borland's OWL, Microsoft's MFC, or one of the many third-party 
Windows class libraries can give your application development a significant leg 
up, since they all provide varying degrees of solutions to problems that you 
will otherwise have to solve on your own. Flowever, some situations call for 
avoiding the vendor-specific C++ libraries that come with your compiler. You 
may need to distribute complete source code for your application to customers 
who do not own the compiler whose C++ library you want to use. Or, you may 
simply want the freedom to switch from one compiler to another down the 
road; that can be hard to do once you have scattered a few hundred calls to a 
proprietary library throughout your application code. 

In cases where you want to avoid using a monolithic, vendor-specific class 
library, C++ still offers an attractive alternative to just using straight calls to the 
Windows API. Rolling your own classes to handle specific aspects of the API 
can not only produce an attractive alternative to straight Windows API calls, it 
can also produce code that is easier to change down the road than code that 
uses a monolithic C++ class library. This article provides the design and imple¬ 
mentation of a class I created to provide easy-to-use, string-based DDE capabilities. 


Ron Burk is the editor of Windows/DOS Developer's Journal and has been a program¬ 
mer for 12 years. You may contact him at Burk Labs, P.O. Box 3082, Redmond, WA 
98073-3082. CIS: 70302,2566. Internet: ronb@rdpub.com (“ . . . luunetlrdpublronb"). 


Windows/DOS Developer’s Journal — Page 31 








Avoiding Reusability 

'Don't write reusable code.' Sometimes I say that in dis¬ 
cussions of building C++ classes, mostly because it sounds 


Listing 1 blddecli.h — Interface to string-based 
DDE class 


#i fndef BLDDECLIJ 
#define BLDDECLIJ 

#include <stddef.h> 

class ADdeConversation 
{ 

public: 

ADdeConversation!){} 

virtual int Requesttconst char ‘Item, char *Buffer, 

size_t Size * 0) = 0; 

virtual int Executetconst char ‘Command) = 0; 

virtual int Poke(const char ‘Item, const char ‘Data) = 0; 

virtual -ADdeConversation!) = 0: 

): 

class TDdeClient 
{ 

public: 

static ADdeConversation ‘NewConversation! 

const char ‘Server, const char ‘Topic, 
const char ‘CommandLine = 0): 

static int Initialize!): 
static int LastErrorO; 

): 

#endif 

/* End of File */ 


more shocking than it is. Isn't reusable code a Good 
Thing? Why on earth would you ever set out to design a 
C++ class that is not reusable? Actually, there are some 


Listing 2 blddecli.c — Implementation of 
string-based DDE class 


I* blddecli.c - implementation of DDE CLIent classes. 

* 

* TDde - Is a local class that maintains the DDEML instance variable. 

* TDdeConversation 

* - is the concrete version of the abstract ADdeConversation 

* exposed in ddecli.h. 

*/ 

♦include <assert.h> 

♦include <limits.h> 

♦include <string.h> 

♦include <windows.h> 

♦include <ddeml.h> 

♦include "blddecli.h" 

// Declare DDE callback function 

HDDEDATA EXPENTRY DdeCal1backCWORO TransactlonType, 

WORD ClipboardFormat. HCONV ConversationHandle, 

HSZ Stringl. HSZ Str1ng2, HDDEDATA MemoryHandle. 

DWORD Datal. DWORD Data2); 

// TDde - local class to maintain global DDE data. 
//////////////////////////////////////////////////////////// 
class TDde 
{ 

public: 

TDdeO {}; 

-TDdeO: 

int Initial1ze(); 

int Uninitialized; 

int LastErrorO; 

static DWORD Instance; 

static int ErrorCode; 

}; 


Doughboy 

Professional Install 2.0 

for Windows 

Doughboy Professional Install uses a visual approach 
to creating installation programs and disk sets. 
Without a single line of programming, you can 
create a robust graphical setup program for your 
application. It's the easiest to use tool of its kind! 

Features of Doughboy Professional Install 2.0 

Absolutely no programming required • Built-in high 
speed data compression • Display of background 
graphic image • Full file integrity checking and error 
handling • Automatic splitting of large files across 
multiple disks • Creation of Program Manager 
groups and icons • System configuration checking • 
No royalty fees • And many more features! 

PC Magazine UK says... 

"Doughboy will cope with all but the most complex 
installations, and it's so simple and quick you'll 
recover the cost the first time you use it" (12/93) 

Suit Otly $149.00! 
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reasons to avoid designing reusable classes, and they 
have to do with both the nature of reusability and the 
nature of programmers. 

If you set out to design reusable code, you must take 
into account the kinds of things lots of other programs 
might need to do, rather than what the program at hand 
needs to do. For example, the program you are building 
might just need to load bitmap resources and display 
them on the screen, but a reusable bitmap class would 
have to handle loading bitmaps, stretching bitmaps, rotat¬ 
ing bitmaps, and on and on - reusability implies a certain 
amount of complexity, and sometimes there is a linear 
relationship between the degree of complexity and the de¬ 
gree of reusability. 

Another problem with designing 
reusable code is that you simply may 
not know enough. If, for example, 
you have never written any DDE 
code and you set out to write the ul¬ 
timate reusable DDE class, there is a 
decent chance you will find yourself 
redesigning it from scratch a year 
later - there is just no substitute for 
experience in the problem space 
when it comes to designing reusable 
solutions. And if your initial, inferior 
design is being used by five different 
applications after a year, you may 
wind up sticking with the inferior de¬ 
sign rather than trying to update all 
those other applications with an im¬ 
proved DDE class. 

In the past, I've heard compiler 
vendors say things like 'We've re¬ 
duced 600 Windows API functions to 
only 25 C++ classes.' What they 
don't mention is that those 25 
classes may each have 24 member 
functions, so that the result is argu¬ 
ably no net reduction of complexity. I 
can, for example, much more easily 
design a DDE C++ class that makes 
DDE easy for you to use if I know in 
detail just exactly what you do and 
don't plan to do with DDE. In other 
words, a C++ class that does not 
have to be reusable can be more us¬ 
able for one specific problem. One 
good side-effect of that lack of reus¬ 
ability is that the caller has fewer de¬ 
pendencies on the class. For exam¬ 
ple, if I know that all you want to do 
with DDE is move an 80-character 
buffer back and forth between two 
applications, I can design a C++ class 
with an interface so bland that it 
could be implemented under Win¬ 
dows, Windows NT, OS/2, or UNIX 
with no change to the class interface. 


Windows/DOS Developer’s Journal — Page 33 


Fast, Full-Featured SQL Engine for Windows 

Ideal for mobile computing as an extension to Client/Server systems 
and applications that run on small to medium sized LAN file servers. 


VBQUERY 


Eile £dit Schema Table Transaction User Fonts Window Help 


Query Input 


select' from xmaslist: 


§ 


Query Control 


Execute 


Browse Query Result 


£urient 

PjrtfViOUV 


Update 

n —i 

Next 

Last 

Delete 


Done 


RECIPIENT 
ADDRESS 
CARD PIC 


ROBERTA WANG 


..MEMO ... 


..BLOB ... 


Execution Tim e 
100 : 00:01 


Schema: BLOBTEST 


Exit! Q|ylayAs Edit 


ROBERTA BANG 
ROGER SMITH 
JAHES DARIN 
JERRY TSAI 
JULIA ROSENBERG 



Blob Size (bytes): 40G40 


Quadbase-SQL for Windows v2.0 is an industrial-strength SQL relational database 
engine, bundled with a set of powerful tools, that allows Windows developers to build 
applications using various languages like Visual Basic, Realizer, Toolbook, 
SQLWindows, C, C++, ObjectView, etc. A unique language-independent embedded SQL 
interface included with the system makes using any Windows language easy. The SQL 
engine, implemented as a DLL, is fully ANSI SQL 86 level 2 compliant, and supports the 
Microsoft ODBC standard, which provides seamless, object-oriented access from Visual 
Basic v2.0. Extensions include referential integrity, scroll cursors, and outer join, along 
with other advanced features such as multi-user concurrency control, crash recovery, 
transaction processing, multiple instances, BLOB data, and read-only schemas for CD 
ROMs. The engine is very fast and compact, and is especially designed to manage large 
amounts of data efficiently. Visual Basic development is enhanced by embedded SQL and 
custom controls for browsing and data entry. dQUERY, an award winning query tool/report 
writer, and VBQUERY, an interactive query tool for Windows, are included for quick 
prototyping of SQL statements. A ‘C’ language API is also provided together with an 
embedded SQL preprocessor. The native file format is dBASE. This product is ideal for 
small to medium sized LAN file servers, notebook, or pen-based systems. Users can benefit 
from advanced relational database features while opening a migration path to SQL servers. 

Quadbase Systems Inc. 

790 Lucerne Dr. #51 
Sunnyvale, CA 94086 
Tel: (408) 738-6989 
Fax: (408) 738-6980 


Call for a free demo disk now. 
Find out why A T& T, Hewlett 
Packard , Nike , EPA, GE and 
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Listing 2 continued 


DWORD TDde::Instance = 0; 

Int TDde::ErrorCode = 0; 

TDde::~TDde() 

{ 

1f(TDde::Instance) // if DDE instance is initialized 
{ 

DdeUninltialize(TDde::Instance); 

TDde: instance = 0: 

) 

) 

int TDde::Initial ize() 

{ 

if(TDde::Instance != NULL) 
return TRUE; 

else if(Ddelnitialize(&TDde::Instance, 
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A Simplified DDE Interface 

DDE is a complicated protocol, even if you use DDEML, 
the higher-level DLL that comes with Windows 3.1 and 
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Figure 1 The demo program in action 


supposedly simplifies DDE programming. DDE conversa¬ 
tions can be synchronous or asynchronous, and they can 
transfer a variety of types of data between applications. A 
really reusable DDE C++ class needs 
to provide client and server abilities, 
handle hot links, and manage a 
good many other things. However, it 
turns out that every time I've needed 
to use DDE, all I really needed was 
the ability to do string-based pokes, 
executes, and requests of DDE serv¬ 
ers such as Excel. 

Not being a language bigot, I used 
WinWord's built-in BASIC interpreter 
the first time I needed to access a 
DDE server. I chose WinWord be¬ 
cause it provided a very easy-to-use 
DDE interface and I was extracting 
data from a server to create Rich 
Text Format for help files, a file for¬ 
mat that WinWord can easily gener¬ 
ate anyway. Unfortunately, as the 
size of my data grew, WinWord be¬ 
came less able to handle it, reacting 
to low memory conditions by abort¬ 
ing or even causing my machine to 
rebootl I finally decided to port the 
code to C++ to avoid these memory 
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problems and to get some much-needed execution speed. 

Staring at the DDEML documentation for a while con¬ 
vinced me that I did not want to write a general-purpose, 
reusable DDE C++ class. All I needed was the ability to do 


synchronous, string-based pokes, executes, and data re¬ 
quests of DDE servers, blddecli.h (Listing 1) shows the in¬ 
terface I came up with. It consists of two classes. The 
first, TDdeClient , is used to create DDE conversations 


Listing 2 continued 



(PFNCALLBACK) DdeCallback. 

ConversationHandle = 0; 


APPCMD CLIENTONLY, 0L) == DMLERR NOJRROR) 

) 


return TRUE; 
else 

} 


return FALSE; 

int TDdeConversation :: InitialIzeCconst char ‘Server, 


) 

const char ‘Topic) 

{ 

TDdeString DdeServer(Server); 


Int TDde::Un1n1t1al1ze() 


{ 

TDdeString DdeTopic(Topic); 


int Status * TRUE; 

ConversationHandle. s DdeConnect(TDde::Instance, 

DdeServer, DdeTopic, (PCONVCONTEXT)NULL); 


If(TDde::Instance 1- NULL) 

{ 

Status = DdeUninitlal1ze(TDde::Instance): 

return ConversationHandle != 0; 

} 



TDde::Instance s 0; 

} 

return Status; 

Int TDdeConversation::Execute(const char ‘Command) 

{ 

DWORD Status; 



) 

HDDEDATA Result; 


Int TDde: : LastError( ) 

Result * DdeClientTransaction((LPBYTE)Command. strlen(Command). 


{ 

ConversationHandle . NULL. CF TEXT. 


Int Result * (int)DdeGetLastError(TDde::Instance); 

XTYP EXECUTE, 5000, iStatus); 


return Result; 

If(InttResult ) == TRUE) 


} 

return 0; 

else If(Result == FALSE) 


static TDde DDE; // static destructor handles de-init 

( 

return intCStatus & 0X00FF); 

) 

else 


// TDdeString - Automate HSZ-string conversion 


//////////////////////////////////////////////////////////// 

return *1; 


class TDdeString 
{ 

public : 

) 


int TDdeConversation::Poke(const char ‘Item, const char ‘Command) 


TDdeStr1ng(const char *String); 

{ 


-TDdeStrlngO; 

DWORD Status; 


operator HSZO { return StringHandle; } 

TDdeString DdeltemCItem); 


private : 

HSZ StringHandle; 

HDDEDATA Result; 


}; 

Result = DdeClientTransaction((LPBYTE)Command. strlen(Command), 
ConversationHandle , Ddeltem, CF TEXT, 


TDdeString::TDdeString(const char ‘String) 

XTYP POKE. 5000, &Status); 


{ 

1f(int(Result) == TRUE) 


StringHandle = DdeCreateStringHandleC 

return 0; 


TDde::Instance, String, CP_WINANSI ) ; 

else if(Result == FALSE) 


assert(StringHandle I s NULL); 

{ 


} 

return intCStatus & 0X00FF); 

} 

else 


TDdeString::~TDdeStr1ng() 


{ 

return -1; 


DdeFreeStringHandle(TDde::Instance, StringHandle); 

) 

} 

int TDdeConversation::Request(const char ‘Item, 


// don’t know why Borland requires this 

char ‘Buffer, size t Size) 


ADdeConversation::~ADdeConver$ation() 

{ 


{ 

DWORD Status; 


) 

TDdeString DdeltemCItem); 

HDDEDATA Result; 


// TDdeConversation - implementation for abstract DDE conv. 

1f(S1ze == 0) // if caller places no size restriction 


//////////////////////////////////////////////////////////// 

Size = UINT.MAX; 


class TDdeConversation : public ADdeConversation 

--Size; // because we will NULL-terminate 


{ 

Result = DdeClientTransaction((LPBYTE)NULL, 0. 


public: 

ConversationHandle , Ddeltem. CF TEXT. 


TDdeConversatlonO; 

XTYP REQUEST. 5000, iStatus); 


virtual -TDdeConversationO; 

If(Result) 


int InitialIzeCconst char ‘Server, const char ‘Topic); 

{ 


virtual Int Request(const char ‘Item, char ‘Buffer, 

DWORD DataLength; 


size_t Size); 

BYTE FAR ‘Data = DdeAccessDatatResult, &DataLength); 


virtual int Execute(const char ‘Command); 

if(Data) 


virtual int Poke(const char ‘Item, const char ‘Command); 

{ 


private: 

assert((DataLength&0xFFFF0000L) == 0); 


HCONV ConversatlonHandle ; 

if((s1ze_t)Data Length < Size) 


}; 

Size = (size.t)DataLength; 
memcpytBuffer, Data, Size); 


TDdeConversation:-.TDdeConversationO 

Buffer[S1ze] * ’\0’; 


{ 

DdeUnaccessData(Result); 


ConversationHandle * 0; 

) 


} 

Dde FreeData Handle(Result); 
return 0; 


TDdeConversation::~TDdeConversation() 

} 


{ 

else 


1f(ConversationHandle ) 

{ 

DdeDisconnect(ConversationHandle_); 

return intCStatus & 0X00FF); 

} 
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with specific DDE servers on specific topics. It also con¬ 
tains an initialization function that gives the calling appli¬ 
cation a way to detect if the DDE package could not in¬ 
itialize itself for some reason; initialization will take place 
implicitly if you don't call the explicit function. The second 


Listing 2 continued 


#i fdef_BORLANDC_ 

((pragma argsused 
#endif 

HDDEDATA EXPENTRY DdeCal1back(M0RD TransactionType. 
WORD ClipboardFormat, HCONV ConversationHandle, 

HSZ Stringl, HSZ String2, HDDEDATA MemoryHandle, 

DWORD Datal, DWORD Data2) 

{ 

switch(TransactionType) 

{ 

case XTYP_REGI$TER : 

case XTYPJINREGISTER : 

return (HDDEDATA)NULL; 
case XTYP_ADVDATA 

return (HDDEDATA) DDE JACK; 
case XTY P_XACT_COMPLETE : 

return (HDDEDATA)NULL; 
case XTYP_DISCONNECT ; 

return (HDDEDATA)NULL; 

} 

return (HDDEDATA)NULL; 

} 


// TDdeClient member functions 
//////////////////////////////////////////////////////////// 

ADdeConversation *TDdeClient::NewConversation( 

const char ‘Server, const char ‘Topic, 
const char ‘CommandLine) 

{ 

DDE.Initialize(); 

TDdeConversation ‘Conversation = new TDdeConversationO; 

if(Conversation->Initialize(Server, Topic)) 
return Conversation; 

else 

{ 

delete Conversation; 
if( CommandLine != NULL 
&& LastErrorO == 0 
) 

{ 

WinExectCommandLine, SWJIDE); 
return NewConversation(Server, Topic); 

} 

return 0; 

} 

} 

int TDdeClient::Initial 1ze() 

{ 

return DDE.Initialized; 

} 

int TDdeClient::LastErrorO 
{ 

return DDE.LastErrorO; 

} 


/* End of File */ 


class, ADdeConversation, is an abstract class - the call¬ 
ing application is not exposed to the details of its 
implementation, so you could make changes to the 
underlying implementation without having to re¬ 
compile the calling application. 

The implementation of these classes is in blddecli.c 
(Listing 2). There is little remarkable in the implementa¬ 
tion. It uses a static object whose destructor takes care of 
de-initializing DDEML if it was initialized. The implementa¬ 
tion hides from the caller all of the morbid details of 
DDEML, such as data handles, string handles, callback 
functions, DDEML instance handles, memory manage¬ 
ment, and so on. 

Using the DDE Classes 

Using the DDE classes is straightforward. For example, 
here is a code fragment that reads the contents of the first 
cell in an Excel spreadsheet (assuming Excel is already 
running): 

ADdeConversation ‘Excel = TDdeClient 

::NewConversation("excel","SheetName"); 
if(Excel == NULL) 
return FALSE; 
char Cel 11[64]; 

Excel->Request(”RlCr, Cell 1, sizeof(Celll)); 

The poke, request, and execute functions all return zero if 
they were successful. If the function fails, it returns the 
eight-bit, application-specific error code. When attempting 
to start a conversation with a server, you can also specify 
a command line that ADdeConversation::NewConversation() 
will HinExecO if the server is not already running. Actually, 
the code assumes the server was not running if it fails to 
establish a DDE connection. Figuring out whether or not 
the server is running and getting it started if not is one of 
the more fragile aspects of using DDE, and you may want 
to handle this specially in your application. 

The code disk contains a simple test dialog that lets 
you interactively exercise the DDE classes. Figure 1 shows 
the test program in action. In the figure, I have connected 
with an Excel spreadsheet and just pressed the 'Poke' but¬ 
ton to set the contents of the first cell in the spreadsheet. 
You can also use the 'Execute' button to execute Excel 
macros (make sure you enclose the action in square 
brackets, e.g., '[New(l)j') or use the 'Request' button to 
obtain the contents of a cell or cell range. 

Summary 

If you are avoiding using monolithic C++ class libraries 
for Windows development for one reason or another, C++ 
still offers lots of opportunities to insulate your code from 
the ugly details of the Windows API and its extensions. 
Small, focused classes are not only easier to write, but can 
also sometimes keep your application better insulated 
from how Windows works than more general-purpose, re¬ 
usable classes. Don't postpone applying C++ until you fi¬ 
nally know enough to write the ultimate reusable C++ 
class for a particular problem, o 
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Leor Zolman 


Please send us your best tricks and 
hacks - those clever pieces of code to 
make things work the way they 
should! You'll receive at least $50 for 
each tip that we print 

Send your submissions: 

- via the Internet to: 
!eor@bdsoft.com 

- from CompuServe to: 
>INTERNET:leor@bdsoft.com 

- or by regular mail to: 

Leor Zolman 

74 Marblehead Street 
Noth Reading, MA 01864 


Video Page Registers, 
Long Window Properties, 
and Global Iterators 
for Turbo Vision 


Video Page Management 


James K. Lawless 
74217.531 @compuserve.com 


I'd like to present a technique for using a somewhat unknown feature of 
EGA and VGA video adapters. 

If you've dealt with text video memory, you are probably familiar with tech¬ 
niques for addressing the video text area. The starting address for the video 
text buffer is usually 8800:0000 for color, 80-column text. This video usually 
can accommodate 16 screens (pages) of 80 columns by 25 lines. 

Applications often build an entire screen scenario across a multitude of 
pages. These applications are then quickly able to perform screen transitions 
simply by calling a BIOS function to change the active display page. 

The little-known feature I mentioned earlier allows an application to actually 
set the offset address of the area that is to be displayed. The BIOS page-man¬ 
agement functions calculate the address of the next screen and use this tech¬ 
nique to set the logical offset address of the video buffer. 

This technique can be used in applications which need to present a scrolling 
list of information to the user. Once the video buffer has been populated with 
the given data, the application simply has to manipulate the Start-Address-High 
(SAH) and Start-Address-Low (SAL) registers of the EGA/VGA CRT controller reg¬ 
isters. These two registers form a 16-bit number that is used as the offset for 
the currently displayed video area. 

The registers are accessed indirectly through a set of ports. Outputting the 
value OxOC to port 0x3D4 will enable you to access the SAL register through 
port 0x3D5 (you can read from or write to this port). 

Outputting OxOD allows access to the SAL register in a similar manner (see 
function set_vid_start()). 



Leor Zolman is a consultant specializing in C programming training, an instructor on 
UNIX topics for Boston University's Center for Information Technology, and "Tech Tips" 
editor for Windows/DOS Developer's Journal. His book, Illustrated C, was publish¬ 
ed in 1992. He may be contacted at 74 Marblehead St, North Reading, MA 01864. 
Internet address: leor@bdsoft.com 



















Listing 1 is a simple file viewer which demonstrates this 
technique. Please note that the code assumes that the 
video adapter is EGA or VGA compatible. 

If you use this technique in your application, do re¬ 
member to reset SAH and SAL back to their original val¬ 
ues before terminating. 


I guess the more things change, the more they stay the 
same. Back around 1975, while a high school student, I had Just 
assembled my first personal computer, an IMSAI 8080, pur¬ 
chased in kit form. Unlike the original Altair 8080 kits, which 
included a 256-byte RAM board, the IMSAI kits came with no 
RAM whatsoever. I only had enough cash for one plug-in S-100 
board, but instead of getting a RAM board (which would have 


Listing 1 fv.c 


Listing 1: fv.c 



// Scroll around the video buffer 

// James K. Lawless 

void view file(void) 

// 2414 4th Ave 

t 

// Council Bluffs, IA 51581 

unsigned short u; 

// 74217.5310compuserve.com 

whiled) { 

// 

u=get_a_key( ) ; 

// File-viewing program demonstrating the video 

switch(u) { 

// scrolling capabilities of EGA/VGA video 

case K_ESC: 

// adapters. 

return; 


case K CRDN: 

linclude <stdio.h> 

If(cur 1ine<(lines-25)) { 

linclude <conio.h> 

cur_line++; 

void add linelchar *1; 

break; 

void view file(void); 


unsigned short get_a_key(void); 

case K CRUP: 

void set.vld startCunsIgned short); 

if(cur 1ine!=0) { 


cur line--; 

#define K ESC (0X001B) 

i 

1 define K HOME (0x4700) 

break; 

Idefine K END (0x4F00) 


Idefine K CRUP (0x4800) 

case K PGDN: 

Idefine K CRDN (0x5000) 

cur 1ine+=25; 

Idefine K PGUP (0x4900) 

If (cur 1 IneXl ines-25)) { 

Idefine K PGDN (0x5100) 

cur 1ine=lInes-25; 

unsigned short lines=0; 

i 

unsigned short cur_line=0; 

break; 

maindnt argc.char **argv) 

case K PGUP: 

i 

if(cur 11ne<25) { 

FILE *fp; 

cur line=0; 

char buff[82]; 

i 


else 

// Set video mode to 80x25 color 

cur 11ne-=25; 

_asm { 

break: 

mov ax.3 


int 10h 

case K HOME: 

) 

cur 11ne=0; 


break; 

if((fp=fopen(argv[l]."r-))==NULL) ( 


fprlntf(stderr. 

case K END: 

"Cannot open Input file Xs\n",argv[l]); 

cur 11ne=lines-25; 

exit(l); 

) 

break; 

// Pass the file 

} 

set vid start(cur line); 

whiled) { 

i 

Ifdfgets(buff.Bl.fp)) 

i 

break: 


add line(buff); 


i 

// Get a keystroke, with extended key support 

fclose(fp); 

unsigned short get_a_key(void) 

view_file(); 

unsigned short u; 

set vid start(0); 

u=getch(): 

exItU); 

1f(!u) 

) 

u=(getch())«8; 


return(u); 

// Insert the specified line into the video buffer. 


void add line(char *s) 

// Set the starting offset of the video buffer. 


void set vid start(unsigned short line) 

static char far *vid=(char far *)0xb8000000L: 

{ 

Int 1; 



// Set high-order byte of the start-address 

for(i=0;1<80;i++) { 

// The register index is 0x0c 

1f((*S“'\n')||(!*s)) 

outp(0x3d4,0x0c ); 

*Vld++=' *• 

outp(0x3d5.(line * 80) » 8 ); 

else 


*vid++=*s+t; 

// Set low-order byte of the start-address 

*vi d++=0xl7; //Attribute... 

// The register index is 0x0d 

i 

outp(0x3d4.0x0d); 

lines++; 

) 

outp(0x3d5.(11ne * 88 1 S 8xff ); 


/* End of File V 
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Listing 2 proplong.c 

/A**************************************************** 

GetPropt hWnd, 

Name: 

HAKEINTRESOURCEI Propld + 1 )))>; 

PROPLONG.C. Listing 2 


File Type: 

} /* function GetPropLong */ 

Library 


Description: 


Library file for managing long window properties. 

/***************************************************** 

Analogous to the standard Windows functions 

Function Name: 

GetProp, RemoveProp and SetProp, except they work 

RemovePropLong 

on long properties. 

Parameters: 

Function List 

hWnd - window handle 

GetPropLong 

Propld - property Id 

RemovePropLong 

Return: 

SetPropLong 

long property 

Portability: 

Description: 

MS Windows 3.1. MSC, BC 

Removes a long property previously set with the 


function SetPropLong. 

/* MS - Windows */ 

LONG RemovePropLong ( HWND hWnd. Int Propld ) 

♦Include <w1ndows.h> 

i 

/* Own */ 

return ( MAKELONGt RemovePropt hWnd. 

♦include <proplong.h> 

MAKEINTRESOURCEt Propld )). 


RemovePropt hWnd. 

/A**************************************************** 

HAKEINTRESOURCEI Propld + 1 )))): 

Function Name: 


GetPropLong 

} /* function RemovePropLong */ 

Parameters: 


hWnd - window handle 



/***************************************************** 

Return: 

Function Name: 

long property 

SetPropLong 

Description: 

Parameters: 

Retrives a long property previously set with the 

hWnd - window handle 

function SetPropLong. 

Propld - property id 

*****************************************************/ 

IProp - long property 

LONG GetPropLongt HWND hWnd. int Propld ) 

Return: 

( 

TRUE (SUCCESS) FASLE (FAIL) 


Description: 

return ( MAKELONGI GetPropt hWnd. 

Associates a long property with a window. 

HAKEINTRESOURCE ( Propld )). 

*****************************************************/ 


TUB Version Control 

For DOS, OS/2 and Windows-NT 


• The experts loved TUB 4: 

"...amazingly fast... TUB is a great system. ’’ PC Tech Journal 
“TUB has features and power to spare... TUB is easy to use and 
the fastest of the reviewed packages. ” Computer Language 
"I will not program without it. ” Uptime Magazine 

• TUB 5.01 adds: 

Automatic branching. Automatic version labeling across branches. 
User defined promote structures, for staged development. Exclusive 
whole-level change migration for customized software. N-way-tree 
version numbers. Branch and full locking. OS/2 & NT support. 
And now... automated conversion from PVCS orMKS RCS! 

• Plus the features they loved in TUB 4: 

Check-in/out locking. Branching, for parallel development. Keywords. 
Full binary file support (does not depend upon NLs in the file like other 
products). Wildcard and list-of-file support; can create lists by scanning 
source code for includes. Can merge (reconcile) multiple simultaneous 
changes and undo intermediate revisions. Network and WORM optical 
disk support. Mainframe-compatible delta generator for Pansophic, 
ADR, IBM, Sperry formats. Integrated with industry-leading MAKE 
from Opus” software. 


MS-DOS $139, OS/2 & NT (with MS-DOS) $195 + shipping. 

5-user net: DOS $419, OS/2+NT+DOS $595. Call for other sizes. 



Burton Systems Software 


PO Box 4157, Cary, NC 27519 (919) 233-8128 

FAX: 233-0716 
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★ 

★ 


Windows Sockets, 
RPC/X DR, 
Telnet, FTP 


for Windows 


* 

o 


Windows Sockets, Berkeley Sockets 
Kernel, RPC/XDR, FTP and Telnet 
toolkits ... all in one 

100% DLL (uses only 4K DOS memory) 
Uses less memory than any other DLL or 
TSR implementation even when loaded 

Up to 128 concurrent sockets 
Coexists with Novell, Banyan or LAN 
Manager at no additional cost 
Supports NDIS, ODI and Packet drivers; 
SLIP and PPP with scripting 

TCP Tools: FTP (drag and drop), TFTP, 
Telnet, LPR/LPD, Back-Up with TAR 


fastfacts: 408.867.4742 
fax: 408.741.0795 

email: mktg@distinct.com 


distinct 

408.741.0781 
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Listing 2 continued 

BOOL SetPropLongl HWND hWnd, Int Propld. LONG IProp ) 

i 

{ 

Re«noveProp( hWnd. MAKEINTRESOURCE( Propld )); 

If ( SetProp( hWnd, MAKEINTRESOURCE( Propld ). 


L0W0RD( IProp ))) 

return ( FALSE ); 

if ( SetProp! hWnd. 

} /* function SetPropLong */ 

MAKEINTRESOURCE( Propld + 1 ). 


HIW0RD( IProp ))) 

/* End of PROPLONG.C */ 

return ( TRUE ); 



Listing 3 proplong.h 


y*n H N-******T>***'»i > * ** ***** *****ii 

Name: 

PROPLONG.H, Listing 3 
File Type: 

!nd ude 
Description: 

Include file for PROPLONG.C 
Portability: 

MS Windows 3.1. MSC, BC 


#1f [defined ( PROPLONG_DEFINED ) 

♦define PROPLONG.DEFINED 

LONG GetPropLongl HWND hWnd, int Propld ): 

LONG RemovePropLong( HIND hWnd, int Propld ); 

BOOL SetPropLongl HWND hWnd, int Propld, LONG IProp ); 

#endif 

/* End of PROPLONG.C */ 


Listing 4 proparay.c 


/***************************************************** 

Name: 

PROPARAY.C. Listing 4 
File Type: 

Library 

Description: 

Library file for managing arrays of window 
properties. Analogous to the standard Windows 
functions GetProp, RemoveProp and SetProp, except 
they work on arrays of properties. 

Function List 
GetPropArray 
RemovePropArray 
SetPropArray 
Portability: 

MS Windows 3.1. MSC. BC 

*****************************************************/ 

/* MS - Windows */ 


Let's Talk. 


Speech Systems, Inc. has answered the demand for powerful, 
accurate speech recognition with its Phonetic Engine ® 500 
(PE500™), a state-of-the-art speech recognition system for 
Microsoft ® Windows™ applications. 


Talking 
To Your 
Computer 
Is No 
Longer 
A Dream 
But A 
Reality 


The PE500 combines the features essential for de¬ 
veloping professional, speech-aware applications: 

• Continuous Speech, which allows you to speak with¬ 
out pauses between words. 

• Speaker Independence, which lets you speak imme¬ 
diately without training. 

• Large Active Vocabulary, which gives you more 
freedom when designing your application. 

• 40,000 Word Standard Dictionary, which you can 
expand with new coords. 


PE500 System Development Kit (PE500 SDK) — 
$995. Includes the following: 


• Interactive Speech Card. 

• Softivare Development Tools for C, C++, and 
Visual Basic. 

• Noise-canceling microphone. 


To receive a copy of the white paper "How to 
Develop Speech-Aware Applications" or to 
order your copy of the PE500 SDK, please con¬ 
tact us at 303.938.1110,303.938.1874 (fax), or 
at 2945 Center Green Court South, Boulder, 
Colorado 80301. 



Speech Systems, Inc. 

Advanced Speech Recognition 
Solutions for Computers 
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Your 
Problem 
Tracking 
System is 
Obsolete 



FREE DEMO DISK! 

Call: 800-695-2303 


Discover Defect Control System 
for Windows,Version 2.0 

You invest three times as much effort 
enhancing existing applications as you 
spend creating new ones. If you still 
maintain a home-grown system to manage 
problems and change requests, you’re 
squandering this investment. 

'DCS is easy to use and performs 
a great service." Software Development 

Automating problem tracking and reporting 
is critical to delivering first-class applica¬ 
tions on time. DCS is the standard because 
DCS is a complete solution. It helps your 
team prioritize workload, respond to end- 
user demands, and uncover problems that 
jeopardize your quality and schedule goals. 

'We reiterate: If your organization is viewed 
as a problem solving entity, DCS provides 
an exceptionally well packaged and easily 
customizable tool kit for 
doing the job and 
managing the process." 

PC Week Labs 

Interested? 

Call and discover how 
DCS can modernize your 
development efforts. 



SOFTWARE^»Ic1:r 

The Leader in Defect Management 

Telephone: (719) 598-3713 Fax: (719) 598-3970 
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limited my output device repertoire to the bank of eight pro¬ 
grammable LEDs on the front panel), I bought a Processor Tech¬ 
nology VDM- 7 video board and a Sanyo 9" monitor. This gave 


me IK of video RAM that mapped a 64-by-16 character display 
somewhere into the 8080's 64K address space. 

That VDM-l board had some remarkable features, two of 
which were hardware scrolling and video ‘masking.' The scrolling 


Listing 4 continued 

#include <windows.h> 

} 

/* Own */ 

♦include <proparay.h> 

} /* function GetPropArray */ 

/***************************************************** 

/***************************************************** 

Function Name: 

Function Name: 

GetPropArray 

RemovePropArray 

Parameters: 

Parameters: 

hWnd - window handle 

hWnd - window handle 

Propld 

Propld - property id 

Number - number of properties 

Number - number of properties 

hProp - array of properties 

hProp - array of properties 

Description: 

Description: 

Retrives an array of properties previously set 

Removes an array of properties previously set with 

with the function SetPropArray. 

the function SetPropArray. 

*****★***★*★*★****★★*★*★★*★**★★******★*★*****★★★*★***/ 

*****************************************************/ 

void GetPropArray! HWND hWnd, int Propld, int Number. 

void RemovePropArray! HWND hWnd, int Propld, 

HANDLE FAR *hProp ) 

{ 

int Number, HANDLE FAR ‘hProp ) 

{ 

int iProp: 

for ( iProp * 0: iProp < Number: iProp++ ) 

{ 

hProp[iProp] = GetProp! hWnd, 

int iProp; 

for ( iProp = 0; iProp < Number; iProp++ ) 

{ 

hProp[iProp] = RemoveProp! hWnd, 

MAKEINTRESOURCE! Propld + iProp )): 

MAKEINTRESOURCE! Propld + iProp )); 



Source code for the 
Borland 3D Chart is available! 



For SDK & Visual Basic 

3D Chart 

• Over 30 of 2D & 3D chart styles 

- Rotation & scrolling 

- Supports printing & clipboard 

Toolbox 

- Creates buttons from bitmaps 
or text 

- Supports scrolling 

- 3D buttons w/ color customization 

- Single/multiple/no-state button 
groups 

Ribbon 

- 3D items with color customization 

- Supports combobox, text, & buttons 

Field Validation 

- Validates date, time, number fields 
& “PIC" statements 

Meter 

- Creates vertical, horizontal, & 
circular gauges with choice of 
needle or color bar as indicators 

- Linear & logarithmic scales 

Table 

- Column & row split windows 

- Multiple row & column selections 

- Check boxes/radio buttons/bitmaps/ 
editable/combobox column 

- Input validation 

- Color customization 

Status Bar 

- Auto scrolled text 

- Stretchable field width 

- Colored progress bar 

- Show date, time, & key states 


Split windows 



Consulting & 

Contract Programming Available 


Free Demo from BBS. 

No Royalties. 30-day MBG. 
Optional with source code. 


Tel: (408) 263-9881 
Fax: (408) 263-9883 
BBS: (408) 263-0892 


Kansmen Corporation 
P.O. Box 360070 
Milpitas, California 95036 
USA 
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RS232-Toolkit, SuperCom 
for DOS, Windows, NT, OS/2 

for MS C/C++, Visual C++, Turbo/Borland C/C++, 
Turbo/Borland Pascal (incl. Protected- mide), IBM C/C++ 


Micro-Software 


SuperCom is the development tool for 
cation software. That means high data 
mission speed. The SuperCom libra: 
tasking operating system like Wini " 

The same programming interfi ‘ 
languages and operating swti 


• Interrupt driven: transmission, receptio 
modem status. Up to 115,200 bps. 

• UARTS: 8250,16450,16550 FIFO, 

• Simultaneous COM_1..COM_36f 

• Direct register programming 



g serial communi- 
and highest trans¬ 
fast even in a multi- 
Windows NT or OS/2, 
among different 


• Flow control: RTS/CTS. D'MSfT^ON/XOFF and 
user defined. ANSI, T*Wv#52J 

• Protocols: ASCII, M>aa5hCMODEM/CRC, 
YMODEM, YMODElKM, ZMODEM. 

• Timer, Ctrl-Break and Bfception handling. 

• Multitasking support (Windows, NT, OS/2) 

• Protected Mode Interface, 386-Technology. 

• User Event Routines under DOS and Windows. 
Under Windows user can even post messages to 
the application using PostMessage. 


Language independent DLL (Windows, NT, OS/2) 
which can be used for simultaneous transfers by 
portaddress. applications. 

[nlimited). • Multiserial board support (AST, ARNET, DigiBoard 
-haring. PC IX, HOSTESS, STARGATE). Reduces loading of 


CPU through support of intelligent DigiBoard PC/Xe, 
PC/Xi boards (up to 112 ports*!!!). 

• Modem support, RS422/485 support. 

• Support for 286 DOS-Extender (e.g. PharLap) 

• No resident drivers*. Just link the LIB. No Royalties. 

• FREE technical support. FREE demo 

• Full source code (C or Pascal and optimized ASM). 

• SuperCom++ (C++ or Pascal OOP) included. 

• Protected Mode Interface (Windows) included. 


C/C++ or Pascal package for DOS only $299 
C/C++ or Pascal package for Windows, OS/2 or NT each $399 
C/C++ or Pascal combo pack for DOS+Windows only $528 
C/C++ or Pascal combo pack for Windows+NT only $598 
C/C++ combo pack for DOS+Windows+OS/2 only $799 
C/C++ combo pack for DOS+Windows+NT only $799 
C/C++ combo pack for DOS+Windows+OS/2+NT only $999 



’Under DOS and Windows 3.x 


VISA, MC, COD, Check accepted. 


ADONTEC Computer Systems Ltd. 

Hoelderlinstr. 32 

D-75433 Maulbronn, Germany 

Phone: 49-7043-40449 
FAX: 49-7043-40440 


Fine Line International 
7000 Malone Rd, Forestville 
CA 95436, USA 

Phone: 1-707-887-3400 
FAX: 1-707-887-1015 
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Listing 4 continued 


} 

int iProp; 

} /* function RemovePropArray */ 

for ( iProp = 0; iProp < Number: iProp++ ) 

{ 

if ( ISetPropt hWnd, 

MAKEINTRESOURCE( Propld ), 

/★**★*★***★★★*★★**★**********★**★★★*★★****★★★*★******* 

Function Name: 

hProp[iProp] ) ) 

SetPropArray 

{ 

Parameters: 

for ( iProp--; iProp >= 0; iProp-- ) 

hWnd - window handle 

{ 

Propld - property id 

RemoveProp( hWnd, MAKEINTRESOURCE( 

Number - number of properties in array 

Propld + iProp )); 

hProp - array of properites 

} 

Return: 

return ( FALSE ); 

TRUE (SUCCESS) FALSE (FAIL) 

) 

Description: 

) 

Associates an array of property with a window. 

* it***************************************************/ 

return ( TRUE ); 

BOOL SetPropArray! HWND hWnd. int Propld, int Number, 

HANDLE FAR *hProp ) 

{ 

} /* function SetPropArray */ 

/* End of PROPARAY.C */ 


The One for Windows! 

Why buy several packages, from different manufacturers, when all you want 
to do is write a complete application? One that includes powerful rules, 
object hierarchies, database support, graphics, and a sophisticated user 
interface? That is, why buy several packages, when just one will do? 

LPA-ADK is The Onel A complete Applications Development Kit, it lets you 
write entire, complex applications with the greatest of ease. Full 32-bit 
addressing means that you will never be short of space, and because 
memory handling is automatic, you don't need to worry about managing 
the resources you are using: it's all done for you. LPA-ADK. includes: 

O High.-level rules and objects for defining the application 
O Graphics, including vectors, fonts, bitmaps and metafiles 
O MDI, dialog, text, user, message, status and control windows 
O Full DDE support, and powerful C and DLL interfaces 
O Database access, including 5QL, ODBC and others 

along with the programming language, function libraries and debuggers 
that you would expect from LPA, the leading Desktop Prolog House. 

Compatible versions are also available for DOS and the Macintosh ... 

... LPA-ADK Is The One! 

Why not phone, fax or email LPA 
today to find out morel 

Logic Programming Associates Ltd 
Phone (US Toll Free): 1-S00-949-7567 

Phone: +44 81 871 2016 - Fax: +44 81 874 0449 

Email: lpa@cix.compuiink.co.uk - CompuServe: 100135,134 
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Developer's Toolkit 


Fastest, Most Powerful Text 
Retrieval Technology Available 

Based on ZylNDEX—leader from the beginning 
in PC text retrieval 



• Search 1 GB in Less Than 5 Seconds 

• Up to SO Million Documents, 10 GB Total Per Index 

• Powerful Searches: Word, Phrase, Proximity. Boolean, 

Wild Cards and More 

• Works Directly with MS Word, WordPerfect, AmiPro. 

dBASE ASCII, and Others 

Ideal for use with high-level application development 
environments such as Visual Basic, ToolBook, 
KnowledgePro, and ObjectVision. 


Windows. DOS. and UNIX/386 
libraries available $3,995 

Call for Specs and Demo. 

100 Lexington Drive • Buffalo Grove, IL 60089 
Phone i708) 459-8000 • Fax (708) 459-8054 
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Long Window Properties and Arrays 
of Window Properties 


William Smith 
Montana Software 
Bozeman, MT 


Under Windows 3.1, I frequently find that I need to 
associate a long value, usually a far pointer, with a win¬ 
dow handle. Properties is the mechanism Windows pro¬ 
vides for associating data with a window handle. The 
functions SetPropO, GetPropO, and RemovePropO accomplish 
this. Unfortunately, these functions associate 16-bit (word 
or handle) data values and do not support long (32-bit) 
values directly. 

Coming up with a solution to this omission is not hard. 
I created long versions of SetPropO, GetPropO, and Re¬ 
movePropO to support long values. I appended a 'Long' to 
the standard names to get the names of the new func¬ 
tions I created: they are SetPropLongO, GetPropLongO, and 
RemovePropLongO. proplong.c (Listing 2) contains the long 
property functions, proplong.h (Listing 3) contains proto¬ 
types for these functions. 


Listing 6 test.pas 

Listing 6: test.pas 

end; 


end; { GlobalFirst } 

program test: 


uses 

procedure TryProcs; 

Objects: 


var 

procedure Local Each (Which : Pointer); far; 

Coll : TCollection; 

begin 

si, s2, s3 : string; 

writeln (string (Which*)); 


end; { Local Each } 

procedure G1obalEach (Which : Pointer); far; 


var 

function LocalFirst (Which : Pointer) : Boolean; far; 

APointer ; pointer; 

begin 

begin 

LocalFirst := (string (Which*) [1] = ’S'); 

asm 

end; { Local First ) 

mov ax, [bp + 8]; 


mov WORD PTR APointer, ax; 

begin 

mov ax, [bp + 10]; 

Coll.Init (10, 10), -si := 'First string'; 

mov WORD PTR APointer + 2, ax; 

s2 := 'Second string’: 

end; 

s3 := 'Third string’; 

writeln (string (APointer*)); 

Coll.Insert (@sl); 

asm 

Coll.Insert (@s2): 

mov sp, bp; 

Coll.Insert (@s3); 

pop bp; 

writeln (’*** Calling ForEach with a local iterator ***'); 

retf 6; 

Col 1.ForEach (©LocalEach); 

end; 

writeln (’*** Calling ForEach with a global iterator ***'); 

end; { G1obalEach } 

Coll.ForEach (@G1obalEach); 


writeln ('*** Calling FirstThat with a local iterator ***'); 

function GlobalFirst (Which : Pointer) : Boolean; far; 

writeln (string (Coll.FirstThat (©LocalFirst)*)): 

var 

writeln ('*** Calling FirstThat with a global iterator ***'); 

APointer ; pointer; 

writeln (string (Coll.FirstThat (©GlobalFirst)*)); 

begin 

writeln (’*** Success! ***'); 

asm 

Coll.DeleteAll; 

mov ax, [bp + 8]; 

Coll.Done; 

mov WORD PTR APointer, ax; 

end; { TryProcs } 

mov ax, [bp + 10]; 


mov WORD PTR APointer + 2, ax; 

begin 

end; 

TryProcs; 

GlobalFirst := (string (APointer*) [1] = 'S’); 

end. 

asm 

{ End of File } 

mov sp, bp; 


pop bp; 


retf 6; 



Listing 5 proparay.h 


/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■A:*********** 

Name: 

PROPARAY.H, Listing 5 
File Type: 

Include 

Description: 

Include file for PROPARAY.C 
properties. 

Portability: 

MS Windows 3.1, MSC, BC 

★★★★♦★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★♦★★★★★★★★■AT i 

#if Idefined ( PROPARAY_DEFINED ) 

#define PROPARAY_DEFINED 

void GetPropArrayt HWNO hWnd, int Propld, int Number, 
HANDLE FAR *hProp ); 

void RemovePropArrayt HWND hWnd, int Propld, 
int Number, HANDLE FAR *hProp ): 

BOOL SetPropArrayl HWND hWnd, int Propld, int Number, 
HANDLE FAR *hProp ): 

#endif 

/* End of PROPARAY.C */ 
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Table 1 Stack usage of local far and global far procedures 

LOCAL FAR 

Calling 

Returning 


push arguments 

mov al,... (FirstThat) 


push bp 

mov sp, bp 


push cs 

pop bp 


call near 

retf 6 


GLOBAL FAR 

Calling 

Returning 


push arguments 

mov al,... (FirstThat) 


push cs 

mov sp, bp 


call near 

pop bp 



retf 4 


The way the long versions work is quite simple - they 
are just wrappers for the standard versions. They break up 
the long value into two properties and hide the details of 
this from the programmer. Also, instead of a string as a 
property name, they require the use of an integer value as 
a property ID. 

While I was at it, I also created versions of SetPropO, 
GetPropO, and RemovePropO that work for arrays of han¬ 
dles. In this case I appended ‘Array to the standard 
names, yielding SetPropArrayO, GetPropArrayO, and Re- 
movePropArrayO. proparay.c (Listing 4) contains the array 
property functions, proparay.h (Listing 5) contains proto¬ 
types for these functions. 

The arrays can be of any size. Just keep in mind that 
the array must be an array of HANDLES. Linder Windows 
3.1, a HANDLE type is 16 bits. The function SetPropArrayO 
stores each item in the array as a single property. It starts 
with the passed-in property ID and increments that value 
for each item. You must therefore be careful not to over¬ 
lap and reuse IDs. For example, if you associate an array 
of 10 handles with a window and use the property ID 1, 
property IDs 1 through 10 will be used, and the next 
available property ID will be 11. 

If you are willing to live with some pointer casts, you 
can use the array functions to associate chunks of mem¬ 
ory, such as structures, with window handles. Just cast the 
structure address to a HANDLE address. 


ods: both require the address of a lo¬ 
cal far procedure or function as their 
argument. Sometimes it would be 
more convenient to use a global iter¬ 
ating procedure shared among sev¬ 
eral routines. Otherwise, each routine 
calling ForEach/FirstThat has to have 
its own copy of the procedure, even 
if those copies are completely identi¬ 
cal. I've found a way to cheat TCol- 
lection and force it to use a global 
procedure. 

If a global procedure is to be 
called as the iterator method, it must 
be modified so that it can return 
safely without the risk of corrupting 
the stack. The code generated by the compiler reveals the 
difference between the stack usage of local far and global 
far procedures (see Table 1). 

As Table 1 shows, the only difference is that, before 
calling a local far procedure, your program pushes an ex¬ 
tra word (BF), which contains a pointer to the local vari¬ 
able area, on the stack. As a consequence, when the pro¬ 
cedure ends, it must remove two more bytes from the 
stack (retf 6 versus retf 4). 

It is very simple to fix the ending sequence of a global 
procedure, generated by the compiler, to resemble that of 
a local one: simply add the sequence 

mov sp, bp 
pop bp 
retf 6 

just before the closing end of the global procedure. 

When you use the pointer parameter passed to the it¬ 
erator procedure in a global far procedure, the compiler 
generates references to the locations BP+6 and BP+8. 
However, when called in place of a local procedure, the 
additional word on the stack shifts this value to the loca¬ 
tions BP+8 and BP+10, making your original reference 
meaningless. The simplest solution to this problem is to 
load the appropriate value into a pointer variable yourself. 
The sequence 



Global Iterators for Turbo Pascal's 
Turbo Vision 


Gabor Deak Jahn 
TRAMONTANA Co 
Budapest, Hungary 

In Turbo Pascal's Turbo Vision, using the TCollection 
type is an efficient way to implement 'arrays' whose ele¬ 
ments differ in type. However, there is a small inconven¬ 
ience when using the ForEach or FirstThat iterator meth¬ 


mov ax, [bp + 8] 

mov WORD PTR APointer, ax 

mov ax, [bp + 10] 

mov WORD PTR APointer + 2, ax 

will place the value passed to the iterator method into the 
local variable APointer. Inside the procedure, this variable 
should be used to address the current collection item. 

Do not forget that, due to the modified stack structure, 
directly calling this procedure is very likely to cause disas¬ 
ter in your program. 

In the accompanying listing, test.pas (Listing 6), you 
will find a small program demonstrating the use of the 
modified iterator procedures. □ 
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A Reusable Banner Dialog 




banner 



Peter D’Agostino 



Visual C++ vl.5 
Borland C++ v4.0 
Symantec C++ v6.1 


Windows applications often need to perform some time-consuming work at 
startup, reading . ini files, creating data structures, and so on. You can make 
that delay a little less irritating for the user by displaying an initial window of 
information during startup. Such windows are variously known as setup 
screens, splash dialogs, and banners. This article provides a simple reusable 
pair of functions you can use to display nice-looking banner dialog for your 
application. 

Using the Banner Dialog 

I was asked to develop a demo version of one of my applications for inclu¬ 
sion with many others on a CD-ROM. I wanted mine to stand out and get the 
user's attention immediately, so decided on modifying the program to display a 
banner dialog at startup. The banner dialog I created had a 'chiseled' look, 
displayed the program's icon in the upper left corner, showed the program 
name centered in large colored script, and presented additional information 
below the program name - all in 3D text. The first version required that I 
manually design a dialog box for the banner and a bitmap for the application 
name to be included in the resource portion of the executable. This scheme 
required too much time to make the banner customizable for use with other 
programs. 

The current version (see Figure 1) creates the banner dialog on the fly, sizing 
it to fit the passed icon and string objects. The application name is displayed in 
a large colored font created at runtime. To use the banner dialog, just include 
banner, h (Listing 1) in your source code and link banner, c (Listing 2) into your 
executable. At the point where you want the banner dialog to appear (such as 
in the UM_CREATE handler of your main window), call OpenBannerO to display the 
banner dialog. When you want the banner dialog to disappear (typically after 
all your initialization is complete and you are ready for user interaction), call 
CloseBannerO. 


Peter D'Agostino is Senior Partner in the ComputechGroup, Inc and has been pro¬ 
gramming in MS Windows for five years. He has developed several game and educa¬ 
tional programs in partnership with Centron Software Technologies, Inc. You may con¬ 
tact him at The Computech Group, 9285 Lerwick Drive, Dublin, OH 43017. CIS: 
72162,1125. 
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Listing 1 banner.h — Interface to banner dialog 
routines 

BOOL OpenBanner(HWND hWnd, HICON hicon, LPSTR lpappname, 

LPSTR lpmsgl, LPSTR 1pmsg2); 
void CloseBanner(void); 

/* End of File */ 
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It takes a team 
effort to pull together 
the technology 
that pulls us ahead. 

At Cheyenne Software, our competitive advantage in leading-edge LAN 
solutions is the direct result of cultivating a corporate culture where tech- 
tiological and professional expertise are shared and the entrepreneurial 
spirit of the individual thrives. Inherently forward-thinking, we are a com¬ 
pany of professionals with the vision to anticipate and address needs by 
advancing technology and services. 

PRODUCT DEVELOPERS 
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ed development and programming experience required. Experience with 
Novell SDK is a plus. 

MS-DOS DEVELOPERS 

You will be responsible for MS-DOS development for ARCSolo. One year 
experience in MS-DOS development and "C” programming skills are 
required- Experience with Assembly and hardware programming are 
advantageous. 

MAC DEVELOPERS 

You will be responsible for the software development for ARCServe. 

Strong “C" experience including one year in MAC development is 
required. A willingness to learn new technology is necessary. Novell 
and/or Appletalk experience a plus. 

We offer a competitive salary and comprehensive benefits package. All 
position are located at our New York corporate headquaters. Relocation 
assistance available. For immediate consideration, fax/mail resume with 
salary requirements and position desired, to: Cheyenne Software Inc., 
Dept. WDD, #3 Expressway Plaza, Roslyn Heights, NY 11577. Attn: 
Manager, Human Resources.EOE M/F/D/V. FAX: 516-484-3093. 
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OpenBannerO accepts five parameters, most of which are 
optional. The function prototype looks like this: 

BOOL OpenBanner(HWND ParentWindow, HICON Icon, LPSTR AppName, 
LPSTR Messagel, LPSTR Message2); 

Figure 1 is helpful in understanding the effects of the vari¬ 
ous arguments. In order, they are: 


(continued on page 47) 


Listing 2 banner.c — Code to implement reusable 
banner dialog 


♦include "string.h" 
include "windows.h" 

♦include "banner.h" 

// color defines 
#define CLRJHITE 0X0FFFFFFL 

#define CLRJLACK 0X0L 

♦define CLRJKGRAY 0X0808080L 

♦define CLRJLUE 0X0FF0000L 

// defines banner appearance 
// app name color 

♦define CLRJAME CLRJLUE 

// border edge in pixels 

♦define BORDER 8 

// name text height multiple of standard font 
♦define NAME_FONT_MULTIPLE 3 

static HICON hicon; 

static LPSTR IpAppName, lpMsgl, lpMsg2; 
static RECT rlcon, rAppName, rMsgl, rMsg2; 
static HFONT hf; 
static HWND hBanner; 

static HFONT CreateNameFontfHOC hDC) { 

LOGFONT If; 

TEXTMETRIC tm; 

GetTextMetrics(hDC.itm); 
memset (ilf. 0, sizeof (LOGFONT)); 
lf.lfCharSet * ANSIJHARSET; 
lf.lfPitchAndFamily = VARIABLEJITCH | FFJOMAN; 
If.lfHeight = NAME_FONT_MULTIPLE*tm.tmHeight; 
lf.lfQuality = PROOFJUALITY; 

IstrcpyOf.lfFaceName,"Times New Roman Bold Italic"): 
return CreateFontlndirectt&lf): 

) 

static void Paint3DText(HDC hDC, LPSTR lpstr, RECT r. 
COLORREF crl. COLORREF cr2) { 

COLORREF crOld = SetTextColor(hDC,cr2); 
int nOldMode = SetBkModediDC, TRANSPARENT); 
DrawTextrilDC. lpstr,-l.ir.DTJENTERIDTJOCLIP): 
0ffsetRect(4r,-l,-l); 

SetTextColor(hDC.crl); 

DrawTextrilDC, lpstr,-l.ir.DTJENTERIDTJOCLIP); 
SetTextColor(hDC.crOld); 

SetBkModediDC, nOldMode); 

1 

static void Paint3DRect(HDC hDC, RECT r) ( 

HBRUSH hBrush; 

HPEN hPen = SelectObjectfhDC,GetStockObject(WHITE_PEN)); 
hBrush = Sel ectObjectChDC,GetStockObject(NULL_BRUSH)); 
Rectangle(hDC,r.1eft,r.top,r.ri ght,r.bottom); 

OffsetRectt&r,-1, -1); 

Sel ectObj ect( hDC ,Crea tePent PS.SOLID, 1 .CLRJKGRAY)): 
Rectangle(hDC,r.1 eft,r.top,r.right,r.bottom); 

DeleteObjectCSelectObjectf hDC.hPen)); 

SelectObjectChDC,hBrush); 

} 

static void PositionObjects(int nWidth, int nHeight) { 
int x. y. dely = 0; 

y * nHeight - max(rIcon.bottom, rAppName.bottom) - 
rMsgl.bottom - rMsg2.bottom: 
y /* 2 + (intXlpMsgl != NULL) + (1nt)(lpMsg2 1= NULL): 
if(rAppName.bottom < rlcon.bottom) 

dely = (rlcon.bottom - rAppName.bottom)/2; 
x = (nWidth - rAppName.right)/2; 
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• ParentUindow - The handle of the window that will be 
the parent of the banner dialog. The dialog will be a 
popup window that stays above this window. 

• Icon - The handle of the application's icon. OpenBan- 
ner() displays this icon in the upper left corner of the 
banner dialog, as shown in Figure 1. 

• AppName - A string containing the name of the applica¬ 
tion. OpenBannerO displays this in a large font. 

• Messagel - A string of text displayed centered, in raised 
text. 

• Message2 - A string of text displayed centered, in en¬ 
graved text. 

CloseBannerO requires no arguments and simply removes 
the banner dialog. 

How It Works 

So that you don't have to create the dialog manually 
and store it as a resource, OpenBannerO creates the dialog 
on the fly by calling CreateDlglndirecto. To do this, it has 
to allocate memory and directly create the data structure 
that describes the dialog; the local function CreateDlgTem- 
plateO performs these tasks. I didn't create individual con¬ 
trol windows for each item on the dialog, since I found it 
easier to deal with sizing and positioning in pixels rather 
than dialog units. Accordingly, in response to the WMJNIT- 
DIALOG message, the code calls the local function InitDlgO, 
which sizes the dialog, centers it on the screen, and posi¬ 
tions the various objects in it. InitDlgO simply sets the 
dialog's minimum size as one half the height and width of 
the screen. It sets the maximum size 
to be large enough to hold the 
passed icon and strings, if any. 

InitDlgO uses the DT_CALCRECT option 
of DrawTextO to get text bounding 
rectangles. PositionObjectsO, as the 
name implies, determines the final 
position rectangle in the dialog for 
each item. The rest of the work is 
done in response to UH_PAINT mes¬ 
sages by three local functions: 

Paint3DRect(), Paint3DText(), and 
DrauIconO. 

To determine the text size, the lo¬ 
cal function CreateNameFontO, which 
specifies the font style and size, is 
called. I chose Times New Roman 
Bold Italic as the most pleasing, but 
this is easily changed. The font 
height used to draw the application 
name is a multiple of the system 
font, which is used for the other 
strings. The multiple is defined as 
NAME_FONT_MULTIPLE in banner, c (Listing 
2). The font is created once and the 
handle saved for reuse throughout 
the life of the banner. It is destroyed 
when the banner dialog is closed in 
response to the UM_DESTROY message. 


□ Request 102 on Reader Service Card □ 



safety standards. 


Coding with standard I/O libraries is fraught with 
danger—file-offset errors, cryptic file formats, and 
datatype access errors. 

Introducing Gamelon, an object-based, platform- 
independent, I/O library that is setting new safety 7 
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file access and eliminates file-offset errors. Free-form 
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data types. Gamelon protects your data so that you 
can work safely and more productively. 

Does your I/O library meet today’s safety standards? 
For more information about Gamelon, contact 
Menai" Coiporation. 

gamalon. 
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1010 El Camino Real, Suite 370, Menlo Park, CA 94025 • info@menai.com 
VOX 415.617.5730 • FAX 415.853.6453 . BBS 415.617.5726 


Listing 2 continued 


0ffsetRect(4rAppName,x + BORDER.y + dely + BORDER): 
if(hlcon) { 

x = (x - rlcon.right)/2: 

if((rAppName.bottom-rAppName.top) > rlcon.bottom) 
dely = ((rAppName.bottom-rAppName.top) - 
rlcon.bottom)/2; 
else dely = 0; 

OffsetRect(&rIcon.x+BORDER.y+dely+BORDER); 

} 

if(lpMsgl) { 

OffsetRect(irMsgl.BORDER + (nWidth-rMsgl.right)/2, 
max(rAppName.bottom.rlcon.bottom) + y): 

} 

1f(1pMsg2) { 

if(lpMsgl) dely * rMsgl.bottom; 
else dely • maxtrAppName.bottom.rlcon.bottom); 
0ffsetRect(irMsg2,BORDER + (nWidth-rMsg2.right)/2. 
y + dely); 

) 

) 

static void InitDlg(HWND hDlg) { 

RECT rc, r; 

HFONT hfOld; 

1nt nWidth. nHeight, n2Cx, n2Cy. n4Brdr = 4*B0RDER; 

HDC hDC = GetDC(hOlg); 
GetWindowRect(GetDesktopNindow(),4rc); 
nWidth = (rc.right/2) - n4Brdr - 

(n2Cx = 2*GetSystemMetrics(SM_CXDLGFRAME)); 
nHeight * (rc.bottom/2) - n4Brdr - 

(n2Cy = 2*GetSystemMetrics(SM_CYDLGFRAME)); 
SetRectEmpty(lrAppName): 

SetRectEmpty(irMsgl): 

SetRectEmpty(JrMsg2): 
if((hf=CreateNameFont(hDC)) != NULL) 
hfOld = SelectObject(hDC.hf); 

DrawText(hDC.1pAppName,-1.irAppName,DT_CALCRECT); 
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Listing 2 continued 


1f(hf) SelectObject(hDC.hfOld); 
if(hlcon) SetRect(&rIcon.0,0,32.32): 
else SetRectEmptyt&rlcon); 

if(lpHsgl) DrawText(hDC,1pMsgl,-1,JrMsgl.DT_CALCRECT); 
if(lpHsg2) DrawText(hDC,1pMsg2,-1,JrMsg2.DT.CALCRECT); 
nWidth = maxtnWidth, 

max(2*(rIcon.right+B0RDER) + rAppName.right, 
maxtrMsgl.right, rMsg2.right))); 
nHeight = max(nHeight,max(rIcon.bottom,rAppName.bottom)+ 
rMsgl. bottom + rM$g2.bottom + 2*B0RDER); 
SetRect(&r,0,0.nWidth+n2Cx+n4Brdr,nHeight+n2Cy+n4Brdr); 
PositionObjects(nWidth+2*B0RDER,nHeight+2*B0RDER); 

MoveWindow(hDlg,(rc.right-r.right )/2, 

(rc.bottom-r.bottom)/2,r.right,r.bottom,FALSE); 
ReleaseDCthDlg, hDC); 

} 

#ifdef _BORLANDC_ 

#pragma argsused 
#endif 

BOOL CALLBACK PASCAL .export BannerDlgProcCHWND hDlg, 

UINT msg, WPARAM wParam, LPARAM IParam) { 

RECT r; 
switch(msg) { 
case WMJNITDIALOG: 
lnitDlg(hDlg); 
return TRUE; 


case WM.PAINT: { 

PAINTSTRUCT ps; 

HFONT hfOldFont; 

HDC hDC = BeginPaint(hDlg,&ps): 
GetClientRect(hDlg.Jr); 

InflateRecti&r,-BORDER,-BORDER); 

Paint3DRect(hDC,r); 

if(hf) hfOldFont = SelectObject(hDC.hf); 

Paint3DText(hDC.1pAppName.rAppName,CLR.NAME, 
CLRJLACK); 

1f(hf) SelectObjectihDC,hfOldFont); 
if(lpMsgl) 

Paint3DText(hDC,1pMsgl,rMsgl, 

CLRJLACK, CLRJKGRAY); 

if(lpMsg2) 

Paint3DText(hDC,lpMsg2,rMsg2, 

CLRJKGRAY.CLRJIHITE); 

if(hlcon) 

Drawlcont hDC,rlcon.1 eft,rIcon.top,hlcon); 
EndPaint(hDlg,4ps); 

} 

return TRUE; 
case WMJRASEBKGND: 
case WMJCONERASEBKGND: 

i f (GetUpdateRect(hDlg,&r,FALSE)) 

FillRect((HDC)wParam,&r, 


The first step in obtaining a 'chiseled' text look is to 
have a light gray background. Rather than change the dia¬ 
log's brush, I chose to handle the h/M_ERASEBKGND messages. 
I use Paint3DRect() to draw a border around the objects. 
Paint3DRect draws the rectangle twice using two different 


colors, offsetting the rectangle by one pixel in the x and y 
directions. The 3D effect created by using white and dark 
gray as the colors enhances the chiseled look. 
Paint3DText() uses a similar method for the text. The color 
of the text and width of the border, which is also used to 
space the objects within the banner 
dialog, are defined at the top of ban¬ 
ner. c (Listing 2). 

There are two main uses for the 
banner dialog: to get the user's atten¬ 
tion (its original purpose in my case), 
or to fill the screen during long load 
times. When the program's load time 
is short, the banner dialog might be 
displayed too briefly to be seen. In 
this case, I make OpenBannerO the first 
function called in response to the 
UM_CREATE message of the main win¬ 
dow and then create a timer with 
SetTimerO. Then, in response to the 
first UM_TIMER message, I call CloseBan- 
ner(). 

In the second case, I open the 
banner in the same way but rather 
than using a timer, close it just be¬ 
fore returning from the first UM_PAINT 
message. This method is most com¬ 
patible with Windows itself, which 
switches to the wait/hourglass cursor 
when a program loads and restores 
the original after the first UM_PAINT. 

You will note that OpenBannerO 
may be called at any time, the only 
limitation being that it ignores the 
request if the banner dialog already 



Do you need a 
bug tracking system 
that does more than 
just log problems? 

ControlFM does more: 

• Product structure supports versions, implementations and releases; 

• Tracks fixes including the module name(s) to be modified; 
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• FVCS Interface for complete development environment. 
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REPOSITORY TECHNOLOGIES, INC. 
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Listing 2 continued 


( HBRUSHJGetStockObject(LTGRAY_BRUSH )) ; 

HGLOBAL hdt; 

return TRUE; 

void FAR* pdt; 

case WM DESTROY: 

if(lpappname) { 

if(hf) 

if( IhBanner) { 

DeleteObject(hf); 

hlcon = hicon; IpAppName = lpappname; 

hBanner = (HWND) NULL; 

lpMsgl = lpmsgl; lpMsg2 = lpmsg2; 

return TRUE; 

if ( (hdt=CreateDlgTemplate( )) 1= NULL) { 

} 

if ( (pdt=GlobalLock(hdt)) 1 = NULL) { 

return FALSE; 

hBanner = CreateDialoglndirectihlnst.pdt, 

} 

hWnd.BannerDlgProc); 

static HGLOBAL CreateDlgTempIate(void) ( 

GlobalUnlock(hdt); 

HGLOBAL hDlgTmplt; 

} 

LPSTR lpdt; 

GlobalFree(hdt): 

long 1 Style = WS POPUP I MS VISIBLE 1 WS DLGFRAME; 

) 

hDlgTmplt = Global AllocIGHND. 16) ; 

} 

ifthDlgTmplt && ((lpdt=(LPSTR) 

) 

G1obalLockthDlgTmplt ))! = NULL)) { 

return hBanner 1= NULL; 

_fmemcpy( 1 pdt, ( LPSTRH1 Styl e, si zeof ( 1 ong )) ; 

G1obalUniocklhDlgTmplt); 

) 

} 

void CloseBannerlvoid) { 

return hDlgTmplt; 

} 

BOOL OpenBannerlHWND hWnd, HICON hi con, LPSTR lpappname, 

LPSTR lpmsgl, LPSTR lpmsgZ) { 

HINSTANCE hlnst = (HINSTANCE) 

GetWindowWordthWnd, GWW HINSTANCE); 

if ( hBanner) DestroyWindow(hBanner ) ; 

} 

/* End of File */ 


exists. You can use it for both opening and closing your 
program, presumably with different passed objects. I tried 
to make the banner dialog easy to modify. You can of 


course do more by including additional parameters as 
//define s in the header file. □ 
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■ Shareware Spotlight 


Parser/TP 


Victor R. Volkman 


With the debut of Windows 3.1, many people pre¬ 
sumed that language-based systems would give way in 
favor of totally GUI-oriented solutions. For example, Win¬ 
dows 3.1 lacks even the rudiments of a batch language. 
However, as even more visual environments appear on 
the programming scene, the need for traditional language- 
based tools continues to grow. Many mainstream Win¬ 
dows products, from installers to spreadsheets, have now 
sprouted macro languages. If your product allows macro lan¬ 
guage programmability, you can be assured that your users 
will soon demand rich and robust expression handling. 

Handling common mathematical expressions, such as 
sin(x)/pi+y, requires a parser. Implementing your own 
parser from scratch can be vexing if you are unfamiliar 
with compiler construction techniques. This column looks 
at the Parser/TP DLL, a Windows library that provides 
code to handle parsing expressions. 

Expression Calculation 

Parser/TP is a recursive-descent expression parser unit 
for Borland Turbo Pascal for Windows (TPW). Since 
Parser/TP is implemented as a DLL, it can be used by any 
available language that knows how to call DLLs, such as 


PowerSoft PowerBuilder, Visual C++, and Visual Basic. 
Header files are provided for TPW and C/C++. 

This DLL includes the basic math operators ( +, -, *, /, 
A ) and functions (sin, exp, cos, In, IoglO, log2, abs, arctan, 
sqr, sqrt, tan, cotan, arcsin, arccos). It supports the mod 
operator by using the '%' character. It also includes con¬ 
stants for pi and e. By registering Parser/TP, you'll receive 
full TPW source code and hence the ability to add addi¬ 
tional operators and functions as you desire. Since the 
DLL is only 25Kb, the additional overhead for your appli¬ 
cation is minimal. 

Typically, the parser receives formula input from the 
user and performs the necessary calculations during pro¬ 
gram runtime. For example, the user of your application 
might enter a formula in a spreadsheet cell and then exit 
the field. Your application would then simply pass this ex¬ 
pression to Parser/TP and capture the result. 

Symbol Table 

Parser/TP supports a dynamic symbol table that is cre¬ 
ated and maintained during parser execution. New vari¬ 
ables are automatically created when they are referenced 
for the first time. They receive an initial value of 0.0. You 


Victor R. Volkman received a BS in Computer Science from Michigan Technological University. He has been a frequent contributor to 
Windows/DOS Developer's Journal since 1990. He is currently employed as Senior Analyst at H.C.I.A in Ann Arbor, Michigan. He 
can be reached by dial-in at the HAL 9000 BBS (313) 663-4173 or by Usenet mail to sysop@hal 9k.com. 
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set the value of a variable by incorporating the '=' opera¬ 
tor in your expression. For example, you can pass in 'my- 
var = sin(anotherVar)*35' in the first call and then evalu¬ 
ate "myvar+2' in the next call. 

A Brief API 

At this point, you might be expecting an API of a dozen 
or so DLL entry points. Quite the opposite is true: 
Parser/TP DLL exports only a single entry point for ail 
functionality described thus far. Specifically, you simply 
call the getExprO function, as shown below: 

short sOK; 
double dAnswer; 

dAnswer = getExprC'100+2/3.5-6", &sOK); 

A complete example C program appears in cal lew. c (List¬ 
ing 1). 

DLL activation takes place via your normal language 
binding method. For example, in C/C++ you can either 
call LoadLibraryO explicitly or use the import library sup¬ 
plied. In TPW, the 'USES' clause invokes the file. 

Documentation, Licensing, and Support 

Documentation for Parser/TP consists of a single, three- 
page README type of file. Given that the product essen¬ 
tially supplies a single DLL entry point, this is entirely ap¬ 
propriate. Some very short example programs in TPW and 
C++ easily clear any remaining ambiguities. 

Parser/TP is marketed as shareware. Accordingly, 
you must register it if you plan to use it beyond a rea¬ 
sonable evaluation period. You must register it before 


Product Information 


Parser/TP, v2.5 (02/14/94) 

Author: Ron Loewy 
HyperAct, Inc. 

P.O. Box 5517 
Coralville, IA 52241 USA 
Email: CompuServe [76350,333] 
Phone/Fax: +7 319 351 8413 


Registration: $30 U.S. ($40 elsewhere), includes full 
source. 

Evaluation: 30 days. 

Where to Get It: You can obtain the Parser/TP DLL 
from the oak.oakland.edu anonymous ftp server (Oak¬ 
land University, Rochester, Michigan) in the 
/pub/msdos/turbopas directory as PARSTP25.ZIP. If you're 
outside the U.S., you can use the Internet ARCHIE utility 
to locate a closer FTP server. 

Alternately, you can download PARSTP25.ZIP from: 

HAL 9000 BBS: +1 31 3 663 4173 or 663 3959 
speeds from 2400 to 28800 bps. 
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redistributing the DLL as part of your own product. Once 
it's registered, you are entitled to an unlimited runtime dis¬ 
tribution of Parser/TP. Registration of Parser/TP entitles 
you to a reasonable amount of technical support and, as 
mentioned earlier, full source code. Ron Loewy of Hyper- 
Act, Inc. can be contacted via CompuServe email, voice 
phone, or fax. 

Concluding Remarks 

Parser/TP supplies an extra piece of functionality that 
seems to be missing from most procedural languages: run¬ 
time expression evaluation. It is small and gets the job 
done with a single entry point into the DLL. Its functional¬ 
ity fits the bill for the vast majority of applications. My 
wish list would include a trunc or round function. The abil¬ 
ity to install callback functions into expression handling 
would also be helpful. Last, some way to save/restore the 
context of the symbol table could be highly useful. Even 
so, Parser/TP can be an indispensable tool for expression 
handling. □ 


Listing 1 callow, c —- Example of using Parser/TP 


// callcw.c - An example of a C program that uses the parser 

//include <string.h> 

//include "parslib.h" 

//include <stdio.h> 

//include <math.h> 

char s[100] = 
double result; 
short valid; 

int main!) 

{ 

printfC'CALC CW - HyperAct Inc.\n”); 
while (strcmpts. "EXIT") 1= 0) { 
printf{"CALC> ”); 
gets(s); 
strupr(s); 

if (strcmpts. "EXIT'') 1= 0) { 
result = GETEXPRts, valid); 
if (valid) 

printf("\n » %E\n", result); 
else 

printf("\n error at position Xd\n", floor(result)); 
} // if .. 

} // while .. 
return 0; 

} 

/* End of File */ 
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Windows Bug of the Month 

Paul Bonneau 


e03s 

Borland C++ v4.0 

Symantec C++ v6.1 


Visual C++ vl .5 


Off-by-one errors can trip up even the best programmers, 
and Windows is by no means immune. In this case, an off-by- 
one error in DrawTextO can cause an exception that crashes 
your program. This bug in Windows was submitted by Andy 
Fields of Signature Computing. His description follows, then my 
analysis, -pb 

The Bug 

I recently discovered a significant bug in the Windows 
3.1 DrawTextO routine which can cause General Protection 
Exceptions and I want to nominate it for bug of the 
month. Normally, when you call DrawTextO, you can pass 
it the address of a string and the length of the string. The 
string does not have to be Wit-terminated if you supply 
the correct string length. However, if you specify the cor¬ 
rect length and do not NULL- terminate the string, under 
some conditions DrawTextO will produce an exception in 
USER (the Windows module that contains DrawTextO and 
other user interface functions). This bug only arises if the 
byte immediately following the string happens to be at an 
invalid address. In my case I had the DT_CALCRECT flag 
turned on, but I have no idea whether this is important. 


By using CodeView I could see that DrawTextO was 
checking the byte beyond the end of the string to see if it 
was zero. It was doing so even though i had supplied a 
string length of 28 and not -1. (The byte it was checking 
would have been the 29th byte of the string.) It was ap¬ 
parently doing the comparison before checking to see if it 
had run out of string. The most insidious thing about this 
bug, of course is that since many things affect the way 
memory is allocated, the bug can occur one time and not 
the next. I was able to reproduce the bug only by exiting 
Windows, restarting it, and repeating the same keystrokes 
every time. 

I was able to circumvent the bug quite easily by pad¬ 
ding the string with a NULL, but you have to know a bug 
exists before you can circumvent it. I have reported the 
bug to Microsoft, who confirmed that it has not been pre¬ 
viously reported. They are investigating it, but insinuated 
that I should be using zero-terminated strings. (My C++ 
routine is a VBX and the string was passed from Visual 
Basic as an HLSTR-, such strings are not Wit-terminated.) 
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Analysis 

This bug occurs when the last 
byte of the string occurs in the last 
byte of the protected-mode memory 
segment containing it. It can be eas¬ 
ily reproduced using the code in 
dtbug. c (Listing 1). All you have to do 
is allocate a 32-byte block of global 
memory (all global memory alloca¬ 
tions are padded up to the nearest 
multiple of 32 bytes), fill it with a 32- 
byte long string, and ask DrawTextO 
to display the string. 

My guess as to what's happening 
in your case is that there is some 4- 
byte header prefix before your 28- 
byte string, which would place the 
last byte at the end of a 32-byte seg¬ 
ment (or some similar arrangement - 
all that is important is that the string 
is at the end of the segment contain¬ 
ing it). 


The bug is due to DrawTextO's 
search for characters. When a 
non-'&' character is prefixed with an 
the acts as an escape and in¬ 
structs DrawTextO to place an under¬ 
line beneath the following character 
instead of drawing the You can 
verify this by modifying the code in 
dtbug. c (Listing 1) to pass the DT_N0- 
PREFIX flag, in which case the UAE 
does not occur. 

The workaround is to either use a 
NULL terminator (even though that is 
not always convenient, as Andy 
points out) or, if the prefix functional¬ 
ity is not required, pass the DT_N0PRE- 
FIX flag to avoid the bug. □ 
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CODE Module Definition Statement 


<?CODE Module-Definition Statement 

CODE attributes [[RXED|MOVEABLE]] [[DISCARDABLE]] [[\ 
PRELOAD |LOADONCaLl]] 


Annotate 


Annotation: 


|The documentation for the FIXED attribute is incorrect. 
Under Windows 3.1. if you mark code or data segments in 
your exe FIXED, the loader ignores that attribute -- the 
segments will be moveable. If you mark code or data 
segments in your dll FIXED, however, the loader will 
make them fixed and will page lock them as well. Due to 
the implementation of GlobalPageLock(). that can result 
in your segments using up precious DOS memory, 
eventually preventing Windows from spawning new 
applications (since each new application needs at least 
512 bytes of DOS memory for a task database entry). 

[Add this annotation to your own online API help file by 
pressing Alt-E-A] 
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WUIMAN’s Kernel 



Visual C++ vl.5 
Borland C++ v4.0 
Symantec C++ v6.1 


This is the eleventh in a series of columns about the design and implemen¬ 
tation of WUIMAN (a Windows User interface MANager). This installment sum¬ 
marizes the structure of the WUIMAN kernel. 

Kernel vs. Environment Interface 

I've had trouble finding a reasonable terminology for describing the overall 
WUIMAN design, but I've settled on the word 'kernel' to describe the part of 
WUIMAN that is essentially portable and, in fact, somewhat ignorant of the fact 
that WUIMAN is a tool for building user interfaces. The "environment interface' 
is what I'm calling the code that builds on the WUIMAN kernel to provide an 
application with a user interface for a particular environment (like Windows). 
Figure 1 is a pictorial description of a theoretical application that links with and 
uses the WUIMAN code. The environment interface provides the code that in¬ 
teracts with the end user and offers a particular style of windows, menus, etc. 
The kernel handles the environment-independent aspects of WUIMAN, most 
notably providing persistence by saving user interface information to disk when 
required. The kernel also provides the handful of functions by which the appli¬ 
cation code can communicate with the environment interface. Ideally, the appli¬ 
cation would do little more than register a set of actions that the user interface 
can evoke (callback functions), and the end user would be able to make signifi¬ 
cant changes to the user interface without requiring any changes to the appli¬ 
cation. How well that will work out in practice remains to be seen. 

While the WUIMAN kernel can easily be 90 percent portable, the WUIMAN 
environment interface is likely to be less so, since it must provide an interface 
to a typically complex, environment-specific GUI API, like Microsoft Windows. 
The kernel is completely independent of the environment interface. If someone 
does not like the environment interface I create for Windows, he/she can cre¬ 
ate a different one and snap it onto the same kernel. At the moment, I think I 
have the kernel reasonably functional and complete, with the exception of im¬ 
plementing events. Before getting into the structure of the kernel code, I will 
first digress to document my latest view of how the kernel handles persistence. 


Ron Burk 


Ron Burk is the editor of Windows/DOS Developer's Journal and has been a program¬ 
mer for 12 years. You may contact him at Burk Labs, P.O. Box 3082, Redmond, WA 
98073-3082. CIS: 70302,2566. Internet: ronb@rdpub.com (" . . . iuunetirdpubironb”). 
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Persistence Again 

How persistence works in WUIMAN is one part of the 
design I keep revisiting and revising. Once again, I think I 
have it figured out. As mentioned in earlier columns, WUI¬ 
MAN is designed to represent your user interface with a 
hierarchical database (tree) of objects, where each object 
can have zero or more child objects and zero or more 
attributes. Each object in the tree has a name, and you 
can refer to a specific object much the same way as you 
would refer to a particular file in a hierarchical file system: 
via a path. For example, the object '/MainWindow' might 
be your application's main window and '/MainWin- 
dow/Ok' might be an 'Ok' button on that main window. 

A significant percentage of the kernel's code is devoted 
to handling the persistence of the WUIMAN objects that 
make up the WUIMAN database. Most of these objects 
will be persistent (that is, any changes you make persist to 
the next invocation of the application), but some will not. 
For example, an environment interface might define a 
submenu for an MDI application that contains a list of the 
child MDI windows currently open; traditionally, those 
menu items would not persist to the next invocation of 
the application (since when you restart the application, 
usually no child MDI windows are open). 

In what I hope is the final design for persistence, the 
kernel makes it look as though every object and attribute 
has a binary property called 'p_Persistent'. If this property 
is set to 1, then the corresponding object will persist; if the 
property is set to 0, it will not persist. For example, an 


application could make a window 
called /hlindow/Ok non-persistent with 
the following function call: 


WUIMAN_Set(7Window/0k", 

”p_Persistent", "0"); 

Nothing would happen at the time of 
this call, but the next time this appli¬ 
cation was started, the main window 
would not contain the 'Ok' button. 

One of the more recent changes 
to the WUIMAN kernel was that I let 
the application send messages di¬ 
rectly to attributes of objects by 
means of a syntax that treats them 
like objects whose names begin with 
All in all, this tactic made the code 
more consistent since, as discussed in 
previous columns, attributes them¬ 
selves have a set of predefined attrib¬ 
utes. So, for example, suppose that 
the 'Ok' button of previous examples 
has an integer property called 
'p_Click* which, if non-zero, makes a 
click sound on the speaker when the 
button is pressed. You could make 
that property non-persistent with the 
following call: 

WUIMAN_Set(”/MainWi ndow/Ok/.p_Click", "p_Persistent”, "0”); 

After that point, the end user could turn clicks on or off 
for that button, but the next time the application ran, the 
'p_Click' property would assume its default value, rather 
than the most recent value assigned by the end user. Un¬ 
der the covers, at the point when persistence was turned 
off for this particular attribute, the kernel would physically 
delete it from the disk database. 

Persistence for a WUIMAN attribute determines 
whether or not the attribute's value gets saved to disk 
when it changes. WUIMAN objects, however, don't really 
have values - their attribute objects contain the values 
that describe them. For WUIMAN objects, persistence de¬ 
termines whether the object and all its child objects reside 
on disk, or only in memory during the current invocation 
of the application. This is one of those cases where setting 
a single attribute in the WUIMAN database can affect 
some or all of the elements beneath that object in the 
database tree. For example, if you turn off the persistence 
of '/MainWindow', the kernel will turn off the persistence 
of all the attributes and objects beneath '/MainWindow' 
in the database tree - if '/MainWindow' is not persistent, 
then '/MainWindow/Ok' cannot be persistent, in much the 
same way that you cannot delete a disk directory unless 
all its files and subdirectories are first deleted. 

The other side of this coin is that you cannot 
make any WUIMAN object or attribute persistent 
without making all of the container objects in that 
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Figure 1 Division of labor in WUIMAN applications 



path persistent as well; setting the 
'p_Persistent' property can affect ob¬ 
jects above it in the path! For exam¬ 
ple, if you issue this call: 

WUIMAN_Set ("/Main/Chi 1 d/Button/. p_Text”, 

"p_Persistent", "1"); 

then you will make the 'p_Text' 
property persistent, but the WUIMAN 
kernel will implicitly force three other 
objects to be persistent: '/Main', 

'/Main/Child', and '/Main/Child/But¬ 
ton', if they were not already persist¬ 
ent. I am making the assumption 
that this behavior will be more useful 
than returning an error and forcing 
the user to make the intervening ob¬ 
jects persistent. In fact, I could be 
wrong and it could turn out to be usually a mistake to 
enable persistence when one of the intervening objects is 
not persistent. 

Another aspect of persistence has to do with running 
multiple instances of the same application. Suppose you 
start an application called App, and then start another in¬ 
stance of the application (I'll refer to the second instance 
as App2). If you start making changes to the user interface 
of App, what should happen to App2? It might be nice if 
changes in any instance of an application were reflected 


in all instances of that application. Unfortunately, that can 
be quite complicated to implement. For example, suppose 
you try to delete a dialog box in App that is currently in 
use in App2. Providing sensible, unsurprising behavior for 
all cases could be a lot of work. WUIMAN takes the 
easy way out for the problem of multiple application 
instances. When WUIMAN loads a database, it checks to 
see whether or not another instance of this application is 
running. If another instance is running, then the kernel ac¬ 
cepts modifications for the current session, but ignores 
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Figure 2 Class hierarchy of WUIMAN kernel 


Legend: 



any attempts by the current applica¬ 
tion instance to update the database. 
Everything seems to work as usual, 
but no changes to the user interface 
will persist to the next session. 

One final area in which persist¬ 
ence arose recently was cloning. The 
user creates new WUIMAN objects 
only by cloning existing ones (the 
special path '/Classes' contains a 
copy of every kind of WUIMAN ob¬ 
ject available, just so the user can 
clone them). It suddenly occurred to 
me that I needed to make a decision 
about whether cloned objects are, by 
default, persistent or not. Originally, 
they simply happened to be persist¬ 
ent due to the vagaries of the imple¬ 
mentation. I revised this behavior so 
that cloned objects are persistent if 
their new parent is persistent; other¬ 
wise, cloned objects are not persist¬ 
ent. My reasoning was that non-per¬ 
sistent containers were made so for a 
reason, so it would be sensible to 
make their children the same way. 
Again, this reasoning may turn out to 
be wrong in practice. 


Emacs for Windows 


WinEmacs is a fully functional Windows 3.1 
version of the industiy standard program editor 
Gnu Emacs, version 19.6. 


WinEmacs has these extended features 


• Separate buffers in different windows 

• Menu and drop-down menu bar 

• Multiple font size and type support 

• Cut and paste mouse support 

• Support for Text and Binary files 

• Clipboard support 

• Binds any arbitrary combination of key and 
key modifers to Emacs Lisp code 

Contact Pearl Software at pearlsoft.com (e-mail), 
510-652-4361 (voice) or 510-652-4362 (fax) for more 
information. Supported version costs $199. 

Call 1-800-WIN-EMACS 

We also provide EMACS consulting services. 

Pearl Software Corporation 

2000 Powell Street #1200, Emeryville, CA 94608 


The Kernel Design 

Figure 2 shows a roughly accurate (some details are 
omitted for clarity) pictorial of the C++ class hierarchy that 
makes up the WUIMAN kernel. In my class naming con¬ 
vention, class names begin with the letter *T, except for 
abstract classes (classes you cannot instantiate), which be¬ 
gin with the letter 'A'. The hierarchy in Figure 2 probably 
suggests more complexity than actually exists - some of 
these classes are very simple. For example, the class TUui- 
NonContainer merely exists to hide various member func¬ 
tions of its parent from any derived classes. 

All of the kernel classes descend from a single root. 
Although the root class, AUuiObject, is an abstract class 
(meaning you can't create an instance of AUuiObject - it 
only exists to serve derived classes), it actually provides a 
good deal of functionality for all descendant classes. For 
example, it handles calls that the application can make to 
delete objects, to create objects (by cloning existing ob¬ 
jects), to rename objects, and so on. Apart from the ab¬ 
stract root class, the kernel classes are divided into two 
camps: objects and attributes. WUIMAN objects ultimately 
represent user interface objects, such as windows and 
menus, while WUIMAN attributes represent aspects of 
those user interface objects, such as properties (color, size, 
position, font, etc.), methods (things you can ask the ob¬ 
ject to do), and events (circumstances under which the ob¬ 
ject can call back to application functions). 
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Objects 

The WUIMAN kernel makes available two classes that 
the environment interface can use and derive from: TUui- 
Container and TUui NonContainer. The only difference be¬ 
tween these two classes is that objects of type TUui NonCon¬ 
tainer (and descendant classes) do not support child ob¬ 
jects. This is a fairly minor distinction, since you could just 
always derive objects from TUuiContainer and give them 
no children if they don't need any. However, I thought 
there might be environment interface classes that inher¬ 
ently have no use for children, in which case it would be 
nice if neither the end user nor the application could suc¬ 
cessfully create children for them (since the object would 
not make any use of them). 

One advantage of this single-rooted hierarchy style of 
programming is that the lower-level classes can provide 
much of the functionality that higher-level classes require. 
The disadvantage that comes with it is that higher-level 
classes can develop deep dependencies on the behavior 
of one or more lower-level classes. I can already see that 
this will be a problem in WUIMAN, since there will be 
cases where a higher-level class will want to modify the 
behavior of a lower-level class, but must make sure that 
lower-level code gets invoked to handle operations such 
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as saving changed attribute values to disk. The best way I 
can see to deal with this problem is to carefully document 
the behavior of the lower-level classes and try to avoid 
changing them down the road. 

Attributes 

Although the single concept of attributes underlies 
them all, for all practical purposes, WUIMAN supports the 
Visual Basic concepts of properties, events, and methods. 
This section briefly reviews the WUIMAN kernel's support 
for these three kinds of attributes. 

As Figure 2 shows, WUIMAN expects environment in¬ 
terface code to use, but not derive new classes from, 
TUuiMethod. At the moment, the one and only purpose of 
TUuiMethod attributes is to provide the names of the meth¬ 
ods that a particular object supports. For example, all WUI¬ 
MAN objects contain an attribute named m_Class because 
all objects must support the m_Class method (it returns a 
string containing the class that this object is an instance 
of). 

Environment interface code can also use, but not de¬ 
rive new classes from, TUuiEvent. TUuiEvent attributes are 
basically strings that contain scripts to execute when an 
event fires. I haven't got this class implemented yet, so I'll 
postpone further description of how I think it will work. 

The attribute classes that the environment can inherit 
from are all properties: TUuilntProperty, TUuiLongProperty, 
TUuiDoubleProperty, and TUuiStringProperty. The idea is that 
all attributes can be represented by either an int, a long, a 
double, or a character string. For example, a Windows 
color is a structure called COLORREF, but it can be repre¬ 
sented by a long, so I can create a new property that han¬ 
dles colors by deriving a class from TUuiLongProperty. 

One reason for restricting properties to one of four 
base variable types is to make it easy to create new kinds 
of properties. The base property classes handle most of 
the details, such as converting the variable to a string 
when it needs to be stored in the disk database, retrieving 
the variable value when requested by the application, and 
so on. My goal is that the main work involved in creating 
a new property class should be in writing the code that 
lets the user edit the property. For example, under Win¬ 
dows, a color property should probably pop up the 
Choose Color common dialog when the user wants to edit 
the property. 

Summary 

My thanks to the folks I've heard from who are inter¬ 
ested in trying out, or even helping implement WUIMAN. 
Within a couple more installments, I hope to be at the 
point where other people can create environment inter¬ 
face classes. At that point, I will try to include a help file 
with enough up-to-date online information so that you 
won't have to leaf through all the past installments to fig¬ 
ure out what's going on. 

This month's code disk has the complete WUIMAN 
source for the project to date, including code from past 
issues. The code disk is widely available via sources listed 
in the table of contents. □ 
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Driver Bug of the Month 

Paul Bonneau 


This month's entry is courtesy of reader Roger Alley, who 
discusses several video driver and GDI bugs he has encountered, 
with workarounds. Even though some of the bugs are 3.0-spe- 
cific, I think it makes an interesting read. I am omitting specific 
company names in this instance because I have not verified that 
this information is up-to-date; in any case, Roger's tale gives 
you a good feel for the sort of problems that can arise when 
you try to test your application with the many different Win¬ 
dows device drivers on the market. Roger's experiences are typi¬ 
cal of the die-hard Windows programmer committed to making 
an application run on a wide range of output devices. - pb 

Your 'column' on driver bugs in the May 1994 issue of 
Windows/DOS Developer's Journal was interesting, both be¬ 
cause I've spent a lot of time looking at (for?) driver bugs, 
and because your two-paragraph description of the 
vgd.drv RLE4 bug was very similar to a message I put up 
on CompuServe (WINSDK) early in the year. I was just curi¬ 
ous as to whether you had seen that message or not? 
(Not that I really care too much, as the more exposure 
these bugs get, the better - just curious). [I did not happen 
to see that message, -pb] 

In any event, as 1 stated, I've spent a lot of time in this 
area, and have a number of interesting stories I would like 
to relate to you. I was working on the movie-playing por¬ 
tion of an application, so many of the bugs I found re¬ 
lated to the RLE4 and RLE8 formats (especially the delta 
commands of those formats, which few applications util¬ 
ize), although I was also responsible for looking at some 
other problems. All of this work was done 18 months ago 


(or longer), so may be irrelevant, but is interesting none¬ 
theless. Also, all of this is off the top of my head, as I no 
longer work for that company, so some of my details may 
be inaccurate. 

One bug, on one of the 16-bit XGA drivers for a par¬ 
ticular video card was sort of funny. As I'm sure you're 
aware, the RLE4 and RLE8 formats are similar, so that it's 
entirely possible that a programmer may write code for 
one and then just copy and change it to create code for 
the other. This appears to be what happened with this 
driver, except the programmer failed to change one jump 
label. The result was that one of the routines (RLE4, I be¬ 
lieve), after following a specific path, would jump back, 
not to the point in the routine where the next command 
was fetched, but to the same point in the other routine! 
This didn't cause it to fault, but the results were colorful, 
to say the least. 

Another video card's driver had a really serious bug 
which caused almost any RLE8 DIB to fault. The code 
looked something like this: 

push bp 
mov bp,sp 

sub sp,10Eh ;made up number 
push ds 

do_the_processing 
pop ds 
pop bp 
ret 
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The 'do_the_processing' actually called a bunch of sub¬ 
routines, which used the local storage allocated by this 
routine. Unfortunately, one of the subroutines wrote to 
[bp-110], which it obviously thought was part of the local 
storage, but was in fact the saved DS value. This routine 
had a very high propensity to fault when it tried to pop 
DS\ It was very easy to patch, however, simply by adding 2 
to the amount subtracted from SP. 

Many early drivers had problems with drawing DIBs 
into memory device contexts, where the destination y 
value was 0. This bug was caused by the fact that DIBs 
are arranged bottom-to-top, while DDBs are in the oppo¬ 
site order. The driver code looked something like this: 

set ds:si to last row of DIB 

set es:di to corresponding row of DDB 

loop: 

copy this row (with translation) 
point ds:si to next row of DIB 
point es:di to previous row of DDB 
if not done, goto loop 

The fact that the code was checking to see if it was done 
after bumping the row pointer meant ES:DI always ended 
up pointing to the start of row -1. Row -1, of course, 
doesn't exist, but the driver made no check for that, it 
simply pointed into the segment which immediately pre¬ 
ceded the actual bitmap. This pointer was never used, but 
the 80386, of course, faults on loading the register, not on 
its use. The interesting thing about this bug was that, if 
the ending selector was actually valid, no fault would oc¬ 
cur. You could perform the function for days without run¬ 
ning into a case where the ending selector was invalid 
and caused a fault. I'm pretty sure this problem has been 
fixed in most drivers. The number of drivers which had 
this bug, however, led me to believe that it was actually 
included in one of the sample drivers Microsoft supplied 
on an early version of the DDK. This is just a guess, of 
course. 

A problem I experienced with a category of video cards 
involved steep lines [abs(rise) > abs(run)) drawn to a 
memory DC. When the line crossed a 64Kb segment (in 
the DDB), it jumped somewhere else. Another bug was 
more interesting. In 32K or 64K color mode, an ExtTex- 
tOutO call to a memory DC with an opaque, non-empty 
rectangle sometimes screwed up. As the rectangle was 
drawn, if the 64K limit was hit, it adjusted its output 
pointer (ES:DI) to point at the row in the next segment, but 
when it calculated the starting offset on that row (using 
rect->left) it failed to take into account the fact that each 
pixel was two bytes (i.e., it set DI to rect->left, not 2*rect- 
>left). This always had the effect of shifting the remainder 
of the rectangle to the left. In addition, if rect->left was 
odd, the resulting pointer pointed into the middle of a 
pixel! This would alter the color of the rectangle (e.g., 
1234 would become 3412), as well as only changing half 
of the pixel value on the left and right edge. Very funny. 


Finally, there were two bugs in GDI which affected 
drawing. The first involved drawing a DIB with 
DIB_PAL_C0L0RS into a monochrome memory bitmap (MMB) 
(this was being done to create a mask for a transparent 
bitmap). GDI would check to see if the driver supported 
DIBs, and then call into the driver code. Many drivers, 
however, would check that the destination was a MMB, 
and then return OxFFFF to GDI to tell GDI to handle it. GDI 
would handle it, of course, but in the meantime it would 
have forgotten that the call had been made with 
DIB_PAL_C0L0RS, and would treat the color table as RGBQUADS. 
This usually wouldn't fault, because GDI had earlier copied 
the color table into its own local heap (although it sub¬ 
sequently over-read that allocation), but the results were 
incorrect. The way I worked around this was to have the 
program initialization code perform a simple test case, and 
then check the results using GetBitmapBitsO. If the wrong 
bits were returned, I just used regular-depth bitmaps for 
the mask (wasteful of memory, but functional). This bug 
existed in 3.10, I'm not sure if it was fixed in 3.11 or not. 

The last GDI bug was just in 3.0, and derived from the 
fact that CreateBitmapO did not always allocate enough 
bytes for a bitmap. The logic it used was absurd. It started 
by calculating the number of lines per segment, and the 
amount of unused space per segment, both of which it 
did correctly. At this point it would have been relatively 
easy to calculate the number of bytes to allocate by using: 

(INKtotalJines / lines_per_segment)) 

* 64K) + 

(REMAINDERttotal_1 ines / 1ines_per_segment) 

* byte$_per_line) 

Instead, the programmer apparently decided to avoid do¬ 
ing the divide, and so just calculated (totaljines * 
bytes_per_line), which would be the amount needed if the 
DDB didn't require a gap between segments, and then 
added in the HIUORD of that calculation multiplied by 
bytes_per_gap. If this final addition wrapped the HIUORD 
again (meaning one or more additional gaps were re¬ 
quired), it was ignored, leaving the final allocation short. 

This bug was frustrating not only in that it was difficult 
to find (it didn't fault until a subsequent drawing operation 
into the bottom of the bitmap occurred), but also because 
the message stated that the application had caused a fault 
in the driver, neither of which had anything whatsoever to 
do with the bug! I learned a lot about the DDB format 
tracking that one down, and the work-around was to 
bump up the number of lines requested to make sure that 
enough were allocated. 

Thanks to Roger for sharing his Windows device driver de¬ 
bugging experience. If you have Windows driver bugs you 
would like to nominate, you can send them to me at 
paul@rdpub.com. If we use your submission, we will send you a 
free W/DDJ T-shirt -pb □ 
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Object-Oriented Programming 


Extending the Actor Environment 

Richard L. Warren 


Introduction 

Actor 4.1 users have available so many types of browsers, text editors, de¬ 
buggers, and test windows that controlling them all on-screen can be confusing 
and time-consuming. When you also take into account the memory consumed 
by each open window when image "snapshots' occur, the need for some envi¬ 
ronment-wide window control becomes apparent. 

This article presents a visual implementation that gives Actor the ability to 
close and cascade all of its top-level development tools and extends its existing 
ability to bring ail of them to the top of the z-order with the right mouse 
button. The implementation uses Booch notation to describe the environment's 
current behavior and document the design and implementation of the desired 
functions. 

The Actor Environment 

When Actor is launched, an instance of ActorApp is created and initialized. 
Next, a class UorkUindow instance variable object called mainUindow (to which 
compiler actions, error messages, and miscellaneous text output are directed) is 
created. mainUindow offers only three functions on its menu: it keeps track of 
other Actor windows; it allows the developer to seal off the application being 
developed for distribution; and it clears its own text display area. 

mainUindow, in turn, creates a UorkSpace class child window which it adds to its 
childList instance variable: an instance of class OrderedCol lection. The UorkSpace 
is where most developer interaction occurs, both through the menu and 
through immediate compilation of code in its text editing area. As ActorApp or 
its mainWindow creates top-level windows (i.e., windows without a parent), 
they are added to the global variable Uindows, which is a set. If the newly cre¬ 
ated top-level windows are to be recreated when Actor starts up the next time, the 
windows are added to the global variable OpenUindows, which is also a set. 


Richard Warren is the Director of Client Computing Services at Judd's, Inc., Shenan¬ 
doah Division, where he is using Windows for Workgroups and Windows NT Ad¬ 
vanced Server applications to implement information systems reengineering. Richard 
has a BS from the University of the State of New York and is a Master of Science 
candidate at Troy State University. He is a retired Navy officer and can be reached via 
CompuServe at 70750,3436. 
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Figure 1 conceptualizes this environment at the class 
level. For clarity, the figure shows all of the Actor distribu¬ 
tion image classes between those mentioned earlier and 
the trunk of the Actor class tree, Object. 

At the object level, Figure 2 illustrates the message 
pathways available and the relationships of owned/owner 
objects (I've represented Windows itself and the WindowsOb- 
jectClass as Booch utility objects). Many Actor classes pro¬ 
vide not only the framework for instantiating instances of 


their class, but also some services (which are objects in 
their own right) that relate to their object class. Actor 
doesn't technically support utilities as free subprograms 
because all entities are organized within the class structure 
as hierarchical objects, even classes themselves. However, 
classes such as WindowsObject and System, which provide 
services distinctly different from instances of their class, 
can be considered utilities for purposes of documentation. 
When a developer selects the Windows option in the 
Actor Display, Windows relays the 
user's menu selection through the 
WM_INITMENU() message. In response, 
the Actor Display iterates over the 
global variable set, Windows, retrieving 
title and iconic state information. For 
each window in the set, the Actor 
Display adds the title and the set's in¬ 
dex + 1000 (arbitrarily) to the sub¬ 
menu the user has requested. If there 
are more than 0 menu items when 
the iteration is completed, the sub¬ 
menu is enabled and it drops down 
so that the user can select which win¬ 
dow is to be at the top of the z-order 
(Figure 3). 

When the user responds with a 
selection, the word pointer of the 
message is queried and compared 
with 1000, the arbitrary integer 
added above. If the value is greater 
than 1000 and there's a window in 
the Windows set whose index is 
equal to the command's value (minus 
the arbitrary 1000), that window is 
restored, forced on screen, and 
brought to the top. 

Possible Approaches 

The simplest approach to provid¬ 
ing an environment-wide window 
control would be to add functionality 
to the existing mechanisms. Doing 
so, however, would create at least 
two additional problems. First, if a 
test application were running, it too 
would have been added to the Win¬ 
dows set, but there'd be no point in 
having it cascaded or closed: the cas¬ 
cading and closing menu options 
should only affect Actor tools. Sec¬ 
ond, it's desirable to be able to use 
the utilities available in WindowsOb- 
jectClass to resize all tools, not just 
bring them to the top of the z-order 
in sequence: bringing up tools in se¬ 
quence without resizing could cause 
one tool to exactly cover another, 
which is not a true cascade. 




Page 64 — Windows/DOS Developer’s Journal 


August 1994 





The problem here is that Uin- 
dowsObjectClass relies on the global 
OpenUindows set, not the global Uindows 
set, to count the number of currently 
open windows so that it can suggest 
where the next window should go. 
Since the number doesn't really 
change, the logical conclusion is that 
all the windows belong at exactly the 
same screen location. A further diffi¬ 
culty is that the UindowsOb- 
ject-.mveUindow method has a prob¬ 
lem with non-client repainting under 
Windows 3.1. 

As Figure 4 shows, all of the Actor 
objects involved have equal access to 
the global OpenUindows set. They view 
it, essentially, with the same shared 
lexical scope (the open 'S’ adorn¬ 
ment). The UindowsObject class uses 
the OpenUindows set when asked to 
suggest the best location for a new 
window rectangle (the sizeRectO 
method). The goal here is to be able 
to use the OpenUindows set while at 
the same time providing an empty 
set that lets UindowsObject suggest 
sizes as if there weren't any other 
windows open. The solution is to 
copy, then empty, the OpenUindows set. 



You can then process each development tool 
signing it a new, cascaded location rectangle, 


by as- 
having 

the tool accept the new rectangle, then telling the tool 
to move its window to the location rectangle pre¬ 
viously supplied. 

Non-tools can be added to a temporary set, then 
added to the 'new' OpenUindow set without relocation after 
all the tool windows have been cascaded. 

The Visual Implementation 

All of this brings us to cas_c!os.act (Listing 1). 



* lnspector:Set limit=4 I 


* Browser. Object 

* iftspectocSei limit—4 1 


J, 22:19, 4/24/1993 */\ 


‘ £lle Edit Search fioit! ; inspect! Browse > 
Show Room! £iesnup! WDl 


Windows 

OpenUindows 


Figure 3 The Actor Display Windows submenu 
with three top-level windows open 
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Listing 1 cas_c!os.act 


Listing 1: CAS_CLOS.ACT 

{usingtidx I w, txt) 

/* By using OpenWindows instead of Windows, a couple tests 

/* This ACT file adds Windows.Cascade All and Windows.Close All 

no longer need to be done: only parentless windows are in 

to the Actor Display. */ 

OpenWindows and the Actor Display won’t be there. */ 
if (w := OpenWindows [ idx]) cand Call IsWindowthandle(w)) 

now(UindowsObject) !! 

then txt := asciizC' " + getText(w)): 
if islconic(w) 

/* Moves the window to the location determined by 

then txt[0] := 

the rectangle in locRect. */ 

endif; 

Def moveWindowtself 1 max min) 

Call AppendMenutp, 0. 1000 + idx, txt); 

{ 

endif; 

locRect cor updateLocRect(self); /* SculptWindow mod */ 

}); 

max := maxSize(self) cor 10000S10000; 

If Call GetMenuItemCount(p) <= 0 

min := minSize(self) cor 0@0; 

then Call EnableMenuItemOiM, 0, MF BYPOSITION bitOr MF DISABLED); 

if width(locRect) > x(max) 

else Call EnableMenuItemOiM, 0, MF BYPOSITION bitOr MF ENABLED); 

then setRight(locRect. left(locRect) + x(max)): 

addCascade(self, p): /* mod for cascade/close */ 

endif; 

endif; 

if height(locRect) > y(max) 

then setBottomtlocRect, top(locRect) + y(max) ) ; 

111 

endif; 

if width(locRect) < x(min) 

now(ActorApp)11 

then setRightdocRect, left(locRect) + x(min)); 

/* Close all browsers, file windows, and attribute editors. */ 

endif; 

Def closeBrowsers(self) 

if height(locRect) < y(min) 

( dotOpenWindows. 

then setBottomtlocRect, top(locRect) + y(min) ) ; 

(usingtow) 

endif; 

if isAncestor(class(ow), ToolWindow) cor 

if hWnd 

isAncestor(class(ow), AttribEdit) cor 

if parent /* Mod - provide for NC Repaint on top-level */ 

isAncestor(class(ow), FileWindow) 

then Call MoveWindowthWnd, 1 eft ( 1ocRect ) , top(locRect), 

then close(ow); 

width(locRect), height(1ocRect), 0); 

endif; 

else Call MoveWindow(hWnd, left(locRect), top(locRect), 

}); 

width(locRect), height(locRect), 1); 
endif: /* End Mod */ 

}!! 

endif: 

/* Bring all Browsers to the front. */ 

}l! 

Def uncoverBrowsers(self) 

{ dotOpenWindows, 

now(WorkWindow)ll 

(usingtwin) 

if isAncestor(classfwin). ToolWindow) cor 

/* Handles selction of a "Windows" menu choice. If a window was 

isAncestor(class(win). AttribEdit) cor 

selected, that window is brought to the front. */ 

isAncestor(class(win), FileWindow) 

Action commandtself, msg 1 wP, window) #[#command] 

then Call BringWindowToTop(handletwin )) ; 

{ if ((wP := wP(msg)) >= 1000) cand (window := OpenWindows[wP-1000]) 

endif; 

then 

}); 

if islconic(window) 

then showtwindow. SW RESTORE); 

}!! 

endif; 

/* Relocate all our browsers in a cascaded fashion */ 

forceOnScreen(window); 

Def cascadeBrowserstself 1 oldSet, nonBrowsers) 

bringToTop(window); 

{ oldSet := copy(OpenWindows) ; 

else 

OpenWindows := newtSet, 16); 

if wP ** 999 

nonBrowsers := newtSet, 16); /* non-tool windows in the env */ 

then cascadeBrowsers(TheApp); 

dotoldSet, 

else closeBrowsers(TheApp); 

(using(ow) 

endif; 

if isAncestor(class(ow), ToolWindow) cor 

endif; 

isAncestor(class(ow), AttribEdit) cor 

111 

isAncestor(class(ow), FileWindow) 
then setLocRect(ow, sizeRect(WindowsObject) ); 

/* Add a separator and the option to cascade existing windows. */ 

moveWindow(ow); 

Def addCascade(self, p) 

Call BringWindowToTop(handle(ow)); 

{ Call AppendMenu(p, MF_SEPARATOR, 0, asciizC'")); 

addtOpenWindows, ow); 

Call AppendMenutp, 0, 999, asciizC'&Cascade all")); 

else addtnonBrowsers, ow); 

Call AppendMenutp, 0, 998, asciiz("C&lose all”)); 

endif; 

Ml 

dotnonBrowsers, 

(using(ow) 

/* Initialize menu contents when pull-down menu requested. */ 

add(OpenWindows, ow); 

Def WM INITMENUCself. msg 1 hM, p, Items) 

}): 

{ if wP(msg) <> (hM := handle(menu) ) 

)); 

then *0; 
endif; 

HI 

p := Call GetSubMenu(hM, 0); 
items := Call GetMenuItemCount(p) ; 
do(items, 

(using(x) Call DeleteMenutp, 0, MF BYPOSITION); 

}); 

do(limit(OpenWindows). 

/* End of File */ 
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4.1 release. Two minor changes to 
the UindowsObject.-moveUindow method 
correct this problem. First, to make 
sure the locRect instance variable is 
not nil (creation state), Steve Hatchett, 
who created ProjectBrowser and 
EDEN, added an updateLocRect(self) 
message which only gets sent if 
locRect is nil. The correct flags for the 
two possible situations, parent or no¬ 
parent, are added later in the 
method. 

The second step is an alteration to 
what happens when a Window sub¬ 
menu choice is made. If the wP value 
is > 1000 and there actually happens 
to be a window in the currently open 
Uindows set, the UorkUindow: command ac¬ 
tion method does the same thing it 
always did. But if the wP passed to it 
by Windows is 999, my arbitrary 
value for the Uindows.CascadeAll sub¬ 
menu option, ActorApp:cascadeBrowsers 
executes. The only other possibility is 
the Uindows.CloseAll option. 

The next step is to provide a 
method, UorkUindow-.addCascade, which 
does the actual submenu item ap¬ 
pending when the UorkUindow:UM_INIT- 
MENU method gets invoked. The 
changes in response to the UM_INITMENU message are fairly 
minor: I substitute the global OpenUindows set for the global 
Uindows set and provide for adding the options to the sub¬ 
menu if there are any tools open. 

The next sections of code focus on ActorApp itself, 
which gets involved in the movement of tools on-screen. 
The ActorApp:closeBrowsers method gets invoked by the 
UorkUindow:command method, since TheApp always hold the 
executing instance of ActorApp during development (it 
holds your App after sealing off). It iterates over the Open¬ 
Uindows set and, if an element is an ancestor of ToolUindow 
(Browser, DebugWindow, Inspector, MethodBrowser, or 
Protocol Browser), an ancestor of AttribEdit (only the At¬ 
tribute Editor itself), or an ancestor of FileUindow( only File 
Editors), it gets a closet) message. The same kind of logic 
works in the ActorApp:uncoverBrowsers method, which is 
only a slight modification of the existing method. This 
method is invoked by a right mouse-dick in the Uorkspace 
through an action method of the same name in that class. 

The real work here gets done by the ActorApp-.cascade- 
Browsers method. This method copies the set, empties it, 
and creates an additional set to hold non-tools. Now Uin- 
dowsObjectClass thinks there aren't any open windows be¬ 
cause the returned tally is 0. As the code iterates over the 
old set, if the window is a tool, it asks UindowsObjectClass 
to suggest a new position, moves the window to that posi¬ 
tion, brings it to the top of the z-order, and adds it to the 
new OpenUindows set. The next call to UindowsObject will 
then provide a different, cascaded position based on the 
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WM NCHITTEST (2.x) 


Annotate 


Annotation 


You can process this message to allow the user 
to drag a window that does not have a title bar. 
When you receive a WM_NCHITTEST message 
and the mouse is in your client area (or whatever 
conditions you want to start the drag), just return 
HTCAPTION rather than passing the message on 
to De(WindowProc() 

Reference: p 37. March 1333 Windows/DOS 
Developer's Journal. 

(Add this annotation to your own online API help 
file by pressing Alt-E-A) 


Save 


Cancel ] 


-ll 


increased tally returned by the sizeO 
request. If the window isn't a tool, it 
is added to the non-tool set. When 
the old set has been processed, the 
non-tools, if any, are added to the 
new OpenUindows set without being 
moved or resized. 

Summary 

With fewer than 100 lines of 
changed or new code, Actor develop¬ 
ers can substantially alter the behav¬ 
ior of the Actor environment itself. 
With the revitalization of Actor and 
an increasingly broad range of Booch 
notation and design tools becoming 
available, even developers with 
'shallow pockets' can now have ac¬ 
cess to powerful object-oriented 
Windows design and development 
environments. □ 
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Bug++ of the Month 

Mark Nelson 


While Borland wasn't the first company to sell a C++ 
compiler for the DOS market, they quickly established 
themselves as the market leader when they released 
Turbo C++. Through several major updates, they have 
managed to maintain a technical lead over Microsoft in 
several key areas. For example, Borland's latest compiler 
supports exceptions, templates, and runtime type identifi¬ 
cation (RTTI), features that Microsoft can only promise in 
an upcoming release. Borland has taken the technical 
high ground, and has managed to put millions of copies 
of their compiler into the hands of end users. Given that, 
you would think any bugs or oversights in their product 
would be confined to obscure cases of rarely used fea¬ 
tures. If only it were so! 

The Case of the Confusing Constructor 

One of the first things you learn about when tackling 
C++ is the special type of function called a constructor. 
The fact that you can initialize objects at the same time 
you allocate their storage space is one of the features that 
gives C++ such a boost over C. 

Something that may not be immediately obvious is 
that fundamental data types such as integers, doubles, 
and floats also accept the constructor initialization syntax. 
In other words, you could initialize an integer when you 
declare it like this: 


void bar() 

{ 

int zot( 4 ); 

This may not look like something you need to use very 
often. After all, C programmers have been able to initialize 
integers just as easily using the assignment operator: 

double tw( void ) 

{ 

int zot = 4; 

However, there is a time when I find it very useful to use 
the constructor initialization syntax for fundamental data 
types. One of the annoyances of C++ is that, in general, 
when you want to make a data member of a class visible 
to the outside world without allowing those same outsid¬ 
ers to modify it, you have to write a short access routine: 

class string { 
protected : 

int length; 
public : 

int get_length(){ return length; } 

This is more than an inconvenience for you, the program¬ 
mer. You have to write an extra piece of code, albeit a 
short piece. The user of your class not only has to learn 
the name and function of the data member, but the name 
of the function needed to retrieve its value. 


Mark Nelson is a programmer for Creenleaf Software and a student at the University of Texas at Dallas. Mark is the author o/The 
Data Compression Book and Serial Communications: A C++ Developer's Guide, both from M9T Books. You can reach Mark 
on CompuServe at 73650,312. 
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class buffer { 

char *buf; 
public : 

const int buf_size; 




In some cases, you can make use of a C++ mechanism 


to make life a little simpler. If you have a data member 
that is initialized to a certain value and then never modi¬ 
fied, you can declare it using the const modifier: 


In this example, you can initialize the 
data member indicating the buffer size, 
and leave it accessible as a public 
member. Even though the data mem¬ 
ber is public, the compiler won't allow 
you to modify it. This means you don't 
need an access function, yet your 
member is still safe. 

The only problem with this ap¬ 
proach is initializing the data mem¬ 
ber. Since it is a const, you can't as¬ 
sign a value to it in the constructor 
body. Instead, you have to use a 
member initializer list, which is a list 
of constructors that precedes the con¬ 
structor body. A typical example 
might look like this: 

buffer::buffer( int count ) 

: buf_size( count ) 

{ 
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Member initializer lists are used routinely in C++ code, 
so it would be pretty surprising to see any commercial 
quality compiler have trouble with them. And, sure 
enough, you can invoke constructors for integers, doubles, 
chars, and so on in member initializer lists. But what 
about elsewhere in your code? 

The code fragment below shows the use of construc¬ 
tors for fundamental data types for two different classes 
of storage, automatic and static: 

int bar() 

{ 

int i( 2 ); //Line 10 

double x( 3.14 ); 
return i + (int) x; 

} 

double y( 1.0 ); // Line 15 

int j( 3 ): 

Symantec and Microsoft both compile this code without 
any trouble, but Borland's compiler issues the following 
messages: 

Borland C++ Version 4.00 Copyright (c) 1993 Borland International 
bug002.cpp: 

Warning bug002.cpp 15: Style of function definition is now obsolete 
Error bug002.cpp 15: ) expected 

Warning bug002.cpp 16: Style of function definition Is now obsolete 
Error bug002.cpp 16: ) expected 
*** 2 errors in Compile *** 
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It looks like the compiler is a little confused by this initiali¬ 
zation syntax. It's easy to see how this could happen - in 
this instance the constructor syntax looks a lot like a func¬ 
tion prototype. The compiler is failing to recognize that 
the value between the parentheses is an expression, not a 
parameter declaration. 

The Moral of the Story 

Fortunately, the workaround for this is obvious, and 
doesn't detract from either the code's performance or 
readability. If you are using Borland's compiler, simply use 
traditional C syntax to initialize elementary data types out¬ 
side a function body: 

int bar() 

{ 

int i( 2 ); // Line 10 

double x( 3.14 ); 
return i + (int) x; 

} 

double y = 1.0; // Line 15 

int j = 3; 

So how did this oversight slip through all those releases of 
Turbo C++ and Borland C++? I could point a finger at 
Borland's test suites for missing an obvious test. However, 
I would be willing to bet that at least part of the problem 


lies in the tech support cycle. Most users who hit this 
problem are going to immediately try the workaround, 
solve their problem, and move on. Considering the diffi¬ 
culty involved in reporting a problem, it just isn't worth 
the trouble to struggle through the process to report a bug 
that you have already worked around. So the problem 
gets swept aside and development proceeds. 

Michael Hyman of Borland provided a vendor review 
of this bug and he pointed out that the compiler does not 
fail on this code if you use the '-A' compiler option. He 
notes that this is a syntax they don't check for unless the 
'-A' option is on, in order to speed compilation. A few 
problems with this perspective come to mind. First, you 
should not have to use special options to get a C++ com¬ 
piler to accept legal, portable C++ code. Second, if you 
use the '-A' option, that disables Borland keywords (e.g., 
Jar) that are vital for Windows programs - you should 
not have to avoid C++ language features just because 
you are creating code for Windows. Finally, Symantec C++ 
generally compiles source code faster than Borland C++ 
and it does not require any special command-line options 
in order to accept this legal C++ construct. 

Thanks to Michael Hyman for taking the time to pro¬ 
vide us with Borland's technical feedback on this bug. If 
you've stumbled upon an interesting C++ bug in the latest 
version of Borland C++, Symantec C++, Visual C++, or Wat- 
com C++, email it to udletter@rdpub.com If we use your bug 
in the magazine, we'll send you a free W/DDJ T-shirt. □ 
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Books in Brief 

First Impressions of Recent Titles 


Ron Burk 


The Indispensable PC 
Hardware Book 

Your Hardware Questions 
Answered 

Hans-Peter Messmer 
$34.95 

Addison-Wesley, 1994 

1003 pages 

ISBN 0-201-62424-9 



The best adjective to describe this unique book is ency¬ 
clopedic. That is not just a fancy way of saying 'big,' al¬ 
though at about 1,000 information-packed pages, this 
book is certainly that. More specifically, though, the book 
truly has the look and feel of an encyclopedia. Like an 
encyclopedia, it is designed to be approachable, even to 
less technical readers. Like an encyclopedia, it descends to 
greater depth on some topics and less on others. Like an 
encyclopedia, it is liberally sprinkled with well-designed 


visual aids (schematics, diagrams, tables, etc.). I don't want 
to minimize the value of this book to working program¬ 
mers, but its style and breadth make it a valuable refer¬ 
ence for anyone who writes about the PC for a living. 

Did you ever need to know the pinouts for your CPU 
or coprocessor? They are here. Never did quite under¬ 
stand the difference between MFM and RLL hard-disk re¬ 
cording modes? It's explained. How do those magneto-op¬ 
tical drives work? There's a two-page explanation, along 
with a detailed diagram. Let's talk esoteric: page 333 has 
a substrate diagram of a storage transistor used in 
EPROMs and page 433 has a table of the Curie tempera¬ 
ture of various ferromagnetic materials. I'm just scratching 
the surface, and these sorts of things are in addition to all 
the standard things you would want of a good PC hard¬ 
ware book: detailed descriptions (from the hardware level 
up to the programming level) of DMA, the UART, the 
floppy drive, the hard drive, the game port, the speaker, 
and so on. 

Like an encyclopedia, this book cannot be the best 
technical reference on every topic. It provides technical de¬ 
tail on the architecture of the various 80x86 CPUs, but 
you can't learn assembly language here. It covers video 


Can't find a book mentioned in this review? You can purchase any book in print from Book Call, by calling (800) 255-2665 or faxing 
(203) 966-4329. 
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hardware, but in-depth coverage of that topic would take 
1,000 pages all by itself. Still, in many significant areas 
(want to do direct DMA to your floppy drive?) the book is 
more complete than any of the other books in my rather 
extensive library. Unlike an encyclopedia, the book tries to 
cover a topic that is evolving at a lightening pace; while 
mostly still quite relevant, the book has no knowledge of 
the Pentium. The difficulty of trying to stay up-to-date is 
compounded by the time required for translation - the 
original German book was probably published in 1993. 

What makes this book even more impressive is that it 
is a translation of the German original. The book does not 
credit the translator, but it should. In sampling the book, I 
did not spot any translation errors or awkwardnesses; in 
fact, the only clue that it was not written in the U.S. is the 
use of chevrons for emphasis. This book is a very impres¬ 
sive accomplishment, one that I expect to use as a hard¬ 
ware reference for years. 


The Undocumented PC 

A Programmer's Guide to I/O, 
CPUs, and Fixed Memory Areas 

Frank Van Gilluwe 
$44.95, includes 3.5" disk 
Addison-Wesley, 1994 
915 pages 
ISBN 0-201-62277-7 


I til: ANirmv SCUUtMAK A Slims 
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A PROGRAMMER’S GUIDE TO I/O, CPI s, 
AND FIXED MEMORY AREAS 


FRANK VAN GILLUWE 


I periodically find myself talking to programmers set¬ 
ting out to write books or articles, and i often tell them 
'include as much experience-based information as possi¬ 
ble.' Programmers as a group are pretty good at digging 
through poorly written specifications, but what they really 
need is information that only comes with experience. This 
book delivers experience-based information in spades. 
The book's subtitle is perhaps more accurate than the title 
- undocumented information is in here, but the book is 
also a valuable hardware reference in areas such as the 
serial port, DMA, timers, the floppy drive, the hard drive, 
the parallel port, the keyboard, and so on. If you are al¬ 
ready familiar with the basics of these aspects of PC hard¬ 
ware, this book supplies the nitty-gritty details that more 
introductory books won't have: bugs, undocumented fea¬ 
tures, and tips on things you should and shouldn't do. 

Frank Van Gilluwe is the author of Sourcer, a commer¬ 
cial disassembly tool. While a few pages are devoted to 
Sourcer, the book is in no way a teaser to get you to 
purchase commercial software. On the contrary, the book 
is sprinkled with free tools that the author has included on 
the code disk for you. Examples of these include: IOSPY 
(an I/O port monitor TSR), SSPY (a utility that displays 
UART statuses), and CPUTEST (a utility that will help you 


locate hidden instructions in any new CPU that Intel ships). 
The utilities are in addition to the many library routines 
and complete source to useful functions such as identify¬ 
ing the type of CPU, safely resetting the machine, speed¬ 
ing up timer 0, communicating with the keyboard control¬ 
ler, and so on. These days, it's not hard to find books that 
cost $44.95, but it's hard to find books at that price whose 
authors invested this much effort in supplying useful infor¬ 
mation, source code, and utilities. 

The book has an extensive index. As fate would have 
it, the first term 1 looked up ('IODELAY') appeared in the 
index with a page number of 4032 (the book contains 
less than 1000 pages). As part of the same search, I found 
a cross reference that referred to code sample 8-4 as 8-2. 
Several other searches were free of problems, so I am 
hoping that the index and cross-references are more error- 
free than my initial experience would indicate. The book 
contains a variety of useful information at the back: a list 
of the 26 programs and two dozen 'interesting subrou¬ 
tines,' found on the code disk, a glossary (including a 
handy list of common chip numbers and what they are 
for), and a six-page annotated bibliography that includes a 
page about products of interest. 

Unfortunately, the PC hardware is too big and has too 
much history for any one book to cover thoroughly. So, 
for example, while this book contains probably the most 
thorough coverage available of the PC keyboard (a part of 
the hardware that acquired many nefarious functions over 
time), it does not pretend to be the ultimate reference on 
video adapters. Less justifiable is the omission of a minor 
feature like the game port. It is worth noting that the 
book contains some information about Japanese PC hard¬ 
ware and software, a topic that is rarely mentioned in 
books or magazine articles. Also notable is a short chapter 
on memory and port issues in designing custom PC hard¬ 
ware cards. I have not really had a good PC hardware 
reference book on my shelves, but in the space of a few 
weeks I suddenly acquired two that are quite different in 
nature: Messmer's The Indispensable Hardware Book and 
this one. 



The Design and Evolution 
of C++ 
Bjarne Stroustrup 
$31.00 

Addison-Wesley, 1994 
461 pages 
ISBN: 0-201-54330-3 


Bjarne Stroustrup is the designer of C++ and continues 
to be active in its standardization by the ANSI and ISO 
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C++ committees. His new book is a wealth of information 
about the language's history and design, and includes 
much anecdotal information that answers common 'why 
does it work like that?" questions. The book does not stop 
with the language as it entered standardization; it dis¬ 
cusses the language from its prehistory (when Stroustrup 
was using Simula) through its most current state. The 
book provides insight into how the standardization proc¬ 
ess really works, and covers the evolution of some of the 
latest language features, such as runtime type identifica¬ 
tion (RTTI), namespaces, and so on. 

This book is not just a collection of answers to histori¬ 
cal trivia questions, such as 'where did the name C++ 
come from?' It provides technical (as well as sociological 
and historical) insight into a large number of aspects of 
the language's design. C++ is a complex language, both 
syntactically and semantically, and understanding the un¬ 
derlying rationale is very helpful to anyone whose goal is 
to become an advanced C++ programmer. I should point 
out that that is not a trivial goal - or one that everyone 
who uses C++ can or should aspire to. if you are in the 
thick of learning to use classes, templates, exception-han¬ 
dling, and so on, this book is a pleasant way to acquire a 
deeper context for assimilating syntax and semantics that 
can seem quite foreign at first. 

One of the things I like least about the evolution of 
C++ is that it has not produced a classless society of C++ 
programmers. There is a sort of upper echelon of folks 
who have the most experience implementing and using 
C++; they tend to have similar backgrounds (e.g., AT&T) 
and communicate mostly in a narrow range of forums 
(both online and in print). Fortunately, Stroustrup has al¬ 
ways exhibited a rather remarkable propensity for sup¬ 
porting, not just tolerating, programming styles and opin¬ 
ions other than his own. The last few years have seen a 
series of books that provide a channel from some of the 
most experienced C++ programmers to 'the rest of us.' 
This book is a unique addition to that welcome process. 


A Field Guide to Windows Icons 

An Introduction to the Commonest 
Icons in North America 

Patricia C. and John V. Hedtke 
$7.95 

Osborne McGraw-Hill, 1993 

136 pages 

ISBN 0-07-881978-4 



When picking books to review, sometimes all I have to go 
on is a title. I thought this book might be about the art of de¬ 
signing good icons. In fact, it is a humor book about Windows 


icons, written in the format of a birdwatching guide. Just be¬ 
fore discarding the book, I thought"Who better to review this 
than the inimitable Stan Kelly-Bootle?" Stan is the author of 
The Devil's DP Dictionary (the Child of Devil's DP Diction¬ 
ary is due out from MIT Press in late 1994), and he is a long¬ 
time columnist for UNIX Review. You can reach him on Com¬ 
puServe (70323,1560) or the Internet (stan@ureview.com). 

The blurb calls it 'A witty take-off on Naturalists' Field 
Guides,' and indeed we do find many icons cleverly pre¬ 
sented with mock-Latin speciations, distinguishing marks, 
habitats, common cries, and ranges, parodying those fa¬ 
miliar pocket-sized bird-spotting manuals. There is also a 
pull-out family tree indicating a Smiley base class from 
which proto, common, rare, and legendary iconic avians 
are supposedly inherited. The idea is certainly promising. 
In fact, Microsoft Press has also launched a quick-refer¬ 
ence series called Field Guides to the Computing Environment 
based on the same concept but adding a Tipmeister wizard 
in safari regalia. Whether MS and Osborne/McGraw-Hill 
are begirding themselves for a bout of look'n'feel litigation 
remains to be seenl 

Book prices being what they are (and climbing), the 
Field Guide to Windows Icons at $7.95 is quite a bargain. I 
see it, though, more as a Christmas stocking-stuffer for the 
computer-novitiate, 'x for Dummies' readers on your prez- 
zie list. The humor and satire slouch along predictably 
without the 'insider' know-how and bite that would ap¬ 
peal to W/DDJ subscribers. For example, the Object Pack¬ 
ager icon is discussed with no reference to the risibilty 
inherent in 'object-as-fad' or Windows not-quite-object 
technology. And, by giving the Object Packager a 'Mid¬ 
American' habitat, the authors seem to have totally mis¬ 
placed the yuppie-academic OT cultural nexus. In general, 
the habitat and range entries for most icons strike me as 
quite arbitrary, and therefore unfunny. Why, for instance, 
should the Clipboard Viewer merit 'Uniform sightings 
throughout the U.S., coastal sightings in Canada'? Perhaps 
any mention of Canada is considered instrinsically hilari¬ 
ous, rather like the stand-up comic's 'mother-in-law'? 

The introductory sections, 'What Is an Icon?' and 'His¬ 
tory of the Icon,' sadly fail to exploit the abundant poten¬ 
tial for black GUI-Phooey humor. Indeed, the phrase 
'graphical user interface' and its acronym are nowhere to 
be seen. Nor do we enjoy the horrors of the toolbar: that 
pandemic IDE mess of inscrutable, tesselated icons, of 
which the least scrutabie are those devised by the user. 
The Smiley (their Dan Quayle spelling 'Smilie' flits by occa¬ 
sionally) is misrepresented as a primitive root for the 
'modern computer icon.' There is no mention of Scott 
Fahlman's pioneering but post-GUI emoticon and the dis¬ 
tinct socio-linguistic roles played by his e-mail glyphic off¬ 
shoots. The Smiley, surely, is us, the writer's interlinear, 
pictographic gloss (akin to the pub bore's 'nudge, nudge' 
or the sitcom's laugh track), whereas the GUI icon is them: 
since you are deemed illiterate, here's a pretty picture-gal¬ 
lery of your application choices. In particular, the Hedtkes 
claim that the 'noseless [sic] Smilie can easily be traced 
back to the pre-computer age ... a typewriter's interpreta¬ 
tion of the figure found in World War II 'Kilroy was here' 
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graffiti.' As one of the dwindling number of survivors from 
those Churchillian days, I must protest that the dominant 
feature of Kilroy was his or her huge Durante Schnoz 
peeping over the horizon. 

The authors present only the 'launching* icons that 
you click or double-click, so there are no drag'n'drop fan¬ 
tasies (nor my own Polish drop'n'drag variant). A stunning 
omission is the archetypical trash-can icon. Recall that the 
whole point of GUI user-mollycoddling, namely a com¬ 
mon, cross-cultural, multi-idiot interface, was rudely 
thwarted when Apple claimed complete dominion over 
the smell'n'feel of its particular MacBin design. Overnight, 
GUI implementers faced the challenge of adjusting their 
bitmaps to provide non-infringing but recognizable recep¬ 
tacles. Given the limitations of 16x32 pixel sets, it is not 
surprising that juries are still mal pendus, peering at blown- 
up slides of diverse lids, handles, and fluted bodies. The 
IBM OS/2 solution, by the way, is a paper-shredding icon, 
but this seems to preclude the 'undo' idea of pre-collec¬ 
tion garbage retrieval. 

A final flame is the uncertain Latinate taxonomy em¬ 
ployed. We drift from the schoolboy Controllum panellum 
(there are funnier, more accurate roots based on imperium 
and tympanum) to the inappropriate Calculator calculi elusivii 
with no clear feeling for phylum, subphylum, class, sub¬ 
class, order, suborder, family, genus, subgenus, and spe¬ 
cies, or for the 'proper' Linnaean typography. We have 
Iconus vulgaris as the common icon, but no Iconidae, the 
ideal name for the family. And surely, with the growing 


use of icon-as-object, we should expect to see the order 
Widgetaria. Even mock-Latin (they call it 'cat Latin') taxon¬ 
omy is funnier when the 'rules' are followed. 

Lest I seem unduly and heavy-handedly critical, let me 
stress that the concept of an icon-spotting guide is brilliant 
and the resulting chuckles-per-doliar will be commendably 
high for the target, non-technical readership. However, 
computer humorists who seek peer approval should avoid 
acknowledgments such as 'And a special thanks goes to 
His Eminence Count Alexander, who is a beacon of humor 
in an otherwise dull venue of second-rate comedians.' 


WINDOWS API 

NEW TESTAMENT 


Windows API New Testament 
Jim Conger 
$39.95, includes CD 
Waite Croup Press, 1993 
1027 pages 
ISBN 1-878739-37-9 
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This is a companion to the book Windows API Bible, 
which I have not examined. In fact, the CD that comes 
with this book includes code for both 
books. This book covers a variety of 
the more peripheral Windows APIs, 
including common dialogs, the Win¬ 
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dows shell, control panel extensions, 
custom controls, file compression, in¬ 
stallation and version information, 
TrueType fonts, ToolHelp, MCI, OLE 
1.0, and DDEML. For each function 
there is explanatory text, reference 
documentation for the relevant API 
functions and messages, and sample 
programs that demonstrate how to 
use the function. I think the form of 
this book is a great idea. The SDK 
documentation is poor, so it would 
be useful if I could buy a book that 
replaced the SDK with accurate, infor¬ 
mative descriptions of the API func¬ 
tions. To try the book out, I looked 
up a couple of sections I have some 
knowledge of: custom controls and 
DDEML. 

Under custom controls, the book 
says 'Prior to Windows 3.1, custom 
controls were more complex to build 
because the control DLL was ex¬ 
pected to provide editing features for 
the dialog box editor.' Huh? If I buy 
a custom control, it darn well better 
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provide the interfaces that integrate it with dialog editors. 
Nevertheless, the chapter goes on to demonstrate that 
you can just make a DLL that registers a window class to 
produce a really lame custom control. Entering a control's 
style bits as a hex constant is not my idea of fun. I was 
greatly unimpressed with the book's custom control chap¬ 
ter. 

I next leafed to the book's description of DDEML. I had 
recently written some C++ classes for DDEML, so the SDK 
documentation was fresh in my mind. This book's descrip¬ 
tion, while not a spectacular improvement, was certainly 
no worse than the SDK's and definitely contained more 
handholding; as always, sample code was also supplied. 
The book includes a sample DDEML program which could 
be a plus to help you get started, although I would trade 
the sample code for a cogent description of how real DDE 
programs deal with the various errors that can arise in a 
conversation. The book's sample code (excerpts in the 
book, complete code on the CD) used MakeProcInstanceO 
instead of smart callbacks, but that was the only coding 
practice I found objectionable. Overall, the code seemed 
clean and clear. 

This book is large and represents a lot of hard work, 
by its breadth alone. It is not a bad book overall, I think 
(although the custom control chapter is not good), but you 
should not expect it to go very far beyond the SDK docu¬ 
mentation in terms of experienced-based knowledge. If 
you want working code that you can grab and play with 
when you're using a new part of the Windows API, then 
this book is ideal for you. The press release for this book 
says that Steve Gibson (InfoWorld columnist, and a guy 
who often knows what he's talking about) has labeled this 
book a 'MUST HAVE' text; I must be missing something, 
for it did not inspire the same succinct praise in me - I 
label it a 'CAN HAVE, ESPECIALLY IF ON SALE, OR IF THE 
COMPANY IS PAYING.' 


It's Time to Clean Your Windows 
Designing GUIs That Work 
Wilbert 0. Calitz 
$44.95 

Wiley-QED, 1994 
ISBN 0 471-60668-5 



I would very much like to clean my windows and de¬ 
sign GUIs that work. I can't afford to hire an expert to 


design my user interfaces, so I eagerly grab any book that 
claims to help me do a better job myself. Before talking 
about the technical content, I have to discuss a non-tech- 
nical aspect of the book that made it difficult to use. I felt 
this book had one of the most unfriendly designs I've 
seen. Every page is littered with horizontal dividing lines, 
bold-faced headers, italic headers, bulleted lists, dashed 
lists, and so on. Many of the 'screen images' in the book 
appear to have been drawn with a graphics tool, making 
them seem more like stick figures than actual images of 
working systems. The minority of pictures that really were 
screen shots were low quality and smudgy. The author 
has used this design in other books, so apparently he 
thinks it is a good one. I hope he will seek other opinions 
before laying out his next book. 

This book consists mostly of list after list of do's and 
don't's, advantages and disadvantages. It covers general 
screen design (how to position and group things in a win¬ 
dow), as well as considerable detail about specific user in¬ 
terface items, such as menus and various controls. There 
are lots of screen examples; they mostly illustrate simple 
individual points. The author conversationally cites rele¬ 
vant studies that provide factual information on various 
detailed aspects of the user interface. The information and 
advice are not intended to be specific to one particular 
GUI environment, and examples are drawn from a variety 
of sources, such as MS-Windows, Macintosh, OPEN LOOK, 
OSF/Motif, and Presentation Manager. 

Once in a while, the advice in the book is too abstract 
to be of use (e.g., 'Provide meaningful, clear, and consis¬ 
tent labels'). Fortunately, the majority of the book is much 
more concrete, such as the advice to lay buttons out 
either horizontally across the bottom of the window or 
vertically along the right side. Some of the advice, such as 
how a menu bar or window border should look and be¬ 
have, is more or less moot for me, since it is behavior 
defined by Windows. At almost 500 pages, there is a 
whole lot of information here to digest, even ignoring 
cases that are less relevant for Windows programmers. 

Since I do not have to design non-Windows user inter¬ 
faces, I couldn't help wishing for a book that was Win¬ 
dows-specific. Isn't the Windows market huge enough to 
deserve its own full-time user interface expert and gadfly 
(a role that Bruce Tognazzini fills for the Mac)? The fore¬ 
word of this book takes a real-life Windows dialog (the 
awful Microsoft PIF editor) and shows how the author 
would have improved it; the rest of the book does not use 
well-known applications to make its points. I would love 
to have a book that demonstrated the good and bad user 
interface designs in existing Windows applications, and 
that gave some innovative solutions to the most common 
Windows user interface design problems (should I validate 
data when the focus leaves the field, or when the dialog 
ends?). While I wait for such a book to come along, I will 
try to improve my user interface design abilities by study¬ 
ing this one. □ 
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Industry-Related News & Announcements 


New Library Provides Signature-Based Security 


Sign-On Verify is a new library that uses Communica¬ 
tion Intelligence Corporation's patented dynamic signa¬ 
ture verification to help your application prompt users 
for their signature and verify that it is not a forgery. In¬ 
itially, the user has to sign his or her name six times to 
create a signature 'template' for later comparison. After 
that, every time a signature is validated, the template is 
updated. The Sign-On Verify library is available for either 
FoxPro, Paradox, Visual Basic, or C. It requires a pen- 
based computer or a digitizer tablet with a desktop com¬ 
puter. 


Using Sign-On Verify, your application can use hu¬ 
man signatures for security rather than passwords or 
PINs. Unlike passwords or PINs, signatures cannot be sto¬ 
len, lost, or easily forgotten. The algorithm in the library 
uses both the image of the signature and its dynamics, 
such as speed and acceleration of each stroke, to elimi¬ 
nate forgeries, even if the forgery looks just like an origi¬ 
nal signature. 

Sign-On Verify costs $395, but a per-computer royalty 
is also required. For more information, contact Sign-On 
Systems, Inc, 9440 Santa Monica Blvd., Suite 705, Beverly 
Hills, CA 90210, (310) 274-7477;fax (310) 274-7585. 


Intel/Microsoft Offer Specification for Faster Video 


Intel and Microsoft have announced that their jointly 
developed Display Control Interface (DCI) specification is 
available. The specification is designed to enable acceler¬ 
ated video playback on PCs running video applications 
under Windows. DCI accelerates video playback frame 
rates by providing a datapath from the software video 
driver to the graphics display subsystem and frame buff¬ 
er. The DCI specification also defines a method to access 
the advanced video features of the next generation of 


graphics controllers, including color space conversion, im¬ 
age dipping, filtering and scaling, and chroma keying. 

DCI supports multiple codec technologies, including In¬ 
tel’s Indeo video. 

The specification is free to qualified graphics and 
hardware vendors. To request the specification, send 
email to Microsoft's Developer Relations group at dci- 
ihv@miaosoft.com, or Intel's Multimedia Software Tech¬ 
nology Croup at dci-ihv@ibeam.intei.com. 


Faison Ships New Custom Control Collection 


Faison Computing offers a new package of object-ori¬ 
ented custom controls for Windows applications, called 
winPAK. The winPAK Professional Edition includes en¬ 
hanced Windows controls (bitmapped radio buttons, bit¬ 
mapped check boxes, bitmapped listboxes, and 
hierarchical listboxes), data entry controls (string input, 
template-based input, integer input, floating-point input), 
and instrumentation controls (faders, gauges, knobs, LED 
readouts, odometers). The controls are designed to be 
added to applications using Borland's Resource Work¬ 


shop. The product comes with C++ sample code and 
documentation. The user manual gives details on how to 
use each winPAK control and how winPAK works with 
Resource Workshop. 

The winPAK Professional Edition costs $249.95. Pur¬ 
chasers of the Introductory Edition, released earlier this 
year, are upgraded automatically. For more information, 
contact Faison Computing, 4199 Campus Dr. #550, Irvine, 
CA 92715, (714) 854-6535 or (800) 500-6535. 
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TurboPower Software Offers Free Patches 


TurboPower Software is now offering free patch files 
of minor revisions via CompuServe, the Internet, and an 
international network of BBSs. A quarterly newsletter to 
customers will tell them about the latest versions of the 
products and where to get the free patches. This series of 
services replaces the company's Fast Update Plan, a paid 
subscription plan in effect since 1989. 

Customers can download the patch files from Com¬ 
puServe, PCVENB section 6 for Pascal, and PCVENE sec¬ 
tion 1 for C/C++. The TurboPower BBS is at (719) 
260-9726. C/C++ files are also on a BBS at (407) 274- 


0862. Internet access is via anonymous FTP from rain¬ 
bow. sosl ,com:\pub\turbopower. Complete details of the 
plan, including international BBS numbers, are available 
in the file update, txt from ail locations. Customers who 
don't have modems or who prefer to receive complete 
new versions on disk can purchase the minor updates 
for $20 plus shipping. 

For more information, contact TurboPower Software, 
P.O. Box 49009, Colorado Springs, CO 80949-9009, (719) 
260-6641 or (800) 333-4160 (international 719-260- 
9136), fax (719) 260-7151. 


Recognita Provides Multi-Language OCR for Scanners 


The Recognita Development Toolkit (DTK) is a pack¬ 
age containing the software optical character recognition 
engine from the company's Recognita Plus 2.0 product. 
Available for Windows, DOS, OS/2, CTOS/PMflll), and 
SCO UNIX/XENIX, the DTK lets you integrate character 
recognition into ordinary applications. The DTK supports 
most scanners, including Epson, Fujitsu, HP, Microtek, 
and Panasonic; the product supports PCX and TIFF image 
file formats and over 70 output text formats, and recog¬ 
nizes 80 languages, including Greek and Croatian. The 


OCR engine can handle multiple fonts, italics, bold, under¬ 
lined text, monospace, typeset, or even faxed documents. 

The Recognita Pius Development Toolkit costs $995 
and includes a setup program, the OCR engine, the 
toolkit and manual, a standalone International Recognita 
Plus 2.0 package for DOS/Windows, a user guide and list 
of supported scanners, and a sample application. For 
more information, contact Recognita Corporation of 
America, 1156 Aster Avenue, Suite F, Sunnyvale, CA 
94086, (408) 241-5772;fax (408) 241-6009. 


BlazeObjects Now Available for DOS, Windows, andOpenVMS 


BiazeObjects is a C++ class library that provides a set 
of platform-independent objects such as index files, com¬ 
mand interface, parsing, error messages, strings, lists, 
date and time handling. BlazeObjects was first intro¬ 
duced on VAX systems and is now available for Win¬ 
dows and DOS. 


BlazeObjects costs $300, $550 with source. To pro¬ 
vide index file capability, it is typically bundled with Fair- 
corn's c-tree Plus, at a price of $750, $1,000 with source. 
For more information, contact Blaze Systems Corpora¬ 
tion, 100 Commerce Drive, Suite 140, Newark, DE19713, 
(302) 733-7236;fax (302) 733-7248. 


Apiary Ships NetWare Client SDK for Visual Basic 


The Netware Client SDK is a software development 
kit for Visual Basic programmers who want to write Net¬ 
Ware-aware applications. The SDK consists of a Win¬ 
dows help file covering the entire NetWare API with 
prototypes in C, Pascal, and Visual Basic, examples of 
NetWare 2.x, 3.x, and 4.x functions, such as drive map¬ 
ping and directory services. The package also includes 


several BASIC files containing the NetWare Client data 
structures and DLL prototypes. 

The NetWare Client SDK for Visual Basic costs $395. 
For more information, contact Apiary, 10201 W. Mark¬ 
ham, ste. 101, Little Rock, AR 72205, (501)221-3699; fax 
(501) 221-7412; CompuServe 70600,761. 


Strike! Offers Dual-Level SQL API 

Strike! for Windows is a collection of DLLs that pro¬ 
vide concurrent access to Microsoft/Sybase SQL Server, 
Oracle, and Gupta Corporation's SQLBase, using SQL. The 
Strikel API consists of two groups of function calls. The 
core set of over 30 functions provide multi-vendor in¬ 
teroperability without code modification, defining stand¬ 
ard methods for common tasks, such as connecting to 
the database and submitting SQL commands and retriev¬ 
ing data. A second group of functions constitute the 


Strikel Services API, which provides access to DBMS-spe¬ 
cific features, such as administrative tasks, backup and re¬ 
store, bulk data transactions, and so on. 

Strike! for Windows costs $495; it comes with sup¬ 
port for Visual Basic v3.0, Visual C++, Skelton Software's 
Clip4Win, and Turbo Pascal for Windows. For more infor¬ 
mation, contact Software<entric, 2231 Gerber Avenue, 
Sacramento, CA 95817-1324, (916) 454-9031;fax (916) 
454-9223; CompuServe 71361,112. 
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DynaZIP Upgrade Spans Disks, Provides Encryption 


DynaZIP Data Compression Toolkit for Windows is a 
royalty-free DLL that gives application developers the 
ability to read, test, create, modify, and write flies compat¬ 
ible with the latest version (2.04g) of PKZIP from PKWare, 
Inc. The new features in this version of the toolkit in¬ 
clude disk spanning with automated disk wiping and for¬ 
matting, data encryption with user-defined passwords, 
creation of Windows-hosted self-extracting .zip files, im¬ 


proved speed, reduced DLL size, and cancellable opera¬ 
tions. 

DynaZIP v2.0 for Windows or Windows NT costs 
$249 per developer station. Owners of DynaZIP vl .0 will 
automatically receive a free upgrade. For more informa¬ 
tion, contact Inner Media, Inc, 60 Plain Road, Hollis, NH 
03049, (603) 465-3216;fax (603) 465-7195. 


INSTALIT Supports Automated Electronic Purchase 


A recent trend in software distribution is to place one 
or more packages on an inexpensive CD-ROM and then 
let the user purchase the key to unlock individual pack¬ 
ages for use. HPI's new version of INSTALIT, their com¬ 
plete product release system, supports that style of 
software distribution. The new version, available in four¬ 
teen national languages, incorporates public and private 
key and RC4 encryption, using technology licensed from 
RSA Data Security. 

Developers and data distributors can encrypt product 
or data flies (using arbitrary-length keys) as they are com¬ 
pressed. Distributions can be built so that even on identi¬ 
cal CD-ROMs or diskettes, a unique key is needed for 
each installation process performed. After the customer 
arranges to purchase the software, the software vendor 
can provide a key that permits product installation. As 
with previous versions, the new version (called IN- 
STALIT/Crypto) supports data compression, patching pro¬ 
grammable automatic release production, scriptable 


compressed library builds, and diskette duplication tech¬ 
nology. Both U.S. and international versions are avail¬ 
able for DOS, OS/2, Windows, and Windows NT. 

The company has also released a communicating re¬ 
mote installer version called hpiOmn; for DOS or Win¬ 
dows. hpifflwn's scripted communications can install or 
intelligently update a product from a local computer to a 
remote computer via ZMODEM, exactly as though a disk¬ 
ette set had been sent to the remote site. The product 
can operate unattended and can also be used for direc¬ 
tory synchronization, hardware and software inventory, 
backup, and general scripted utility functions at remote 
sites. 

INSTALIT/Crypto prices start at $299. hpi Omni prices 
start at $349. Both products are royalty-free. For more in¬ 
formation, contact HPI, 917-C Willowbrook Drive, 
Huntsville, AL 35802, (205) 880-8782 or (800) 448-4151; 
fax (205) 880-8705; BBS (205) 880-8785. 


lnstantCom//CAS Handles UpTolO Fax Modems 


Instant Information's new lnstantCom//CAS Toolkit 
lets you give your application multiline faxing support 
with Intel's SatisFAXtion fax modems. The toolkit offers 
two APIs: the standard DCA/Intel CAS vl .2 and Instant In¬ 
formation's own IcanFAX API, which offers a simpler and 
more comprehensive API, including DTMF support and 
larger control over graphic images. 

The standard versions of the drivers support up to 10 
fax modems on one PC. The Toolkit's drivers are ail TSRs 
that include Windows support and that can be optionally 
loaded into high memory or EMS to conserve conven¬ 


tional memory. Future versions of the drivers will include 
VxD drivers and support for other hardware platforms. 
The package includes debugging versions of the APIs to 
help developers diagnose problems. 

The lnstantCom//CAS Toolkit costs $595, a price that 
includes a 10-copy sublicense; distributing more than 10 
copies costs more. For more information, contact Instant 
Information, Inc, 7618S.W. Mohawk Street, Tualatin, OR 
97062, (503) 692-9711;fax (503) 691-1948; BBS (503) 
691 -0502; Telex: 883075; Internet: attmaU.comlinstantl. 


Desaware Creates Version Stamper for VB 


Windows 3.1 supports a version resource for ex¬ 
ecutable modules that helps installation programs avoid 
overwriting existing modules with incorrect versions 
(older versions, wrong language, etc.). Unfortunately, Vis¬ 
ual Basic does not provide any easy way to create the ap¬ 
propriate version resource for the executables it 
produces. VersionStamper-VB vl .0 is a new tool for Vis¬ 
ual Basic v3.0 that lets Visual Basic programmers embed 
version information in their executables. 

Visual Basic executables typically depend on multiple 
DLLs and custom controls (VBXs). VersionStamper-VB 
vl .0 lets you specify which DLLs, VBXs, OLE custom con¬ 


trols, or other files your program requires, and what 
range of version numbers for those files must be pre¬ 
sent; the program stores that information in a version re¬ 
source in your executable. At runtime, the dwvstamp. vbx 
custom control can automatically verify the presence 
and versions of the files required for your application to 
run. 

VersionStamper-VB vl .0 costs $129. For more infor¬ 
mation, contact Desaware, 5 Town & Country Village 
*790, San Jose, CA 95128, (408) 377-4770; fax (408) 
371-3530; CompuServe 70303,2252. 
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GX Graphics v3.0 Supports 24-bit Color 

GX Graphics is a general-purpose graphics library for 
DOS that supports a wide variety of compilers, lan¬ 
guages, and video adapters. The new version, GX Graph¬ 
ics v3.0, now supports 24-bit color and screen 
resolutions up to 1280x1024. This version also supports 
the latest VESA graphics standard and over 50 different 
SVGA chipset revisions; support for "mode X' graphics, 
often used by games programmers, is also included. 

GX Graphics v3.0 includes over 175 functions and 
supports logical operations, clipping, world coordinates, 
mouse and event routines, text, and drawing to virtual 


buffers. The package includes the GX Kernel library, 
which supports memory handling (conventional, EMS, 
XMS, and disk), color conversion and dithering and hard¬ 
ware panning and scrolling. The library handles all 
modes of the Hercules, CGA, EGA, VGA, and SVGA adapt¬ 
ers. 

GX Graphics v3.0 costs $249, $299 for 16-bit pro¬ 
tected mode, or $699 with source. Upgrades cost $69. 

For more information, contact Genus Microprogramming, 
1155 Dairy Ashford, Suite 200, Houston, TX 77079. 


NetManage Ships RPC Kit for NT 


NetManage is shipping a new RPC SDK for building 
RPC client/server applications under Windows NT. The 
SDK is based on the ONC (Open Network Computing) 
RPC/XDR (Remote Procedure Call/External Data Repre¬ 
sentation) standard. The package includes an RPCGEN 
protocol compiler, sample code, and both client and serv¬ 
er support for the NT environment. Applications devel¬ 
oped with the RPC SDK are compatible with the RPC DLL 


in NetManage's Chameleon32NFS, a Windows NT NFS cli¬ 
ent and server package. The kit provides support for RPC 
development on NT running on either an Intel, DEC Al¬ 
pha, or MIPS platform. 

The NetManage RPC SDK costs $500. For more infor¬ 
mation, contact NetManage, Inc, 7 0725 North De Anza 
Blvd, Cupertino, CA 95014, (408) 973-7171;fax (408) 
257-6405. 


Spreadsheet Control Offers Excel 4.0 Compatibility 


VisualTools, Inc. is now shipping Formula One/VBX, a 
custom control that lets developers add spreadsheet ca¬ 
pabilities to their Windows applications. The product is 
compatible with any environment that supports VBXs, in¬ 
cluding Visual Basic, Visual C++, and Borland C++. The 
control requires 500Kb and can read existing Microsoft 
Excel 4.0 files, retaining all font, formula, and formatting 
information; it can also create files that Excel can read di¬ 
rectly. The calculation engine includes 126 spreadsheet 
functions. A 'virtual mode' lets you use the product as a 
front end to databases, using the spreadsheet as a data 
browser or record editor. 


Other features included in Formula One/VBX include 
in-cell editing a separate edit bar control, a C API and 
C++ wrapper class for Visual C++ users, custom func¬ 
tions, named ranges, iteration, automatic formula syntax 
checking drag-and-drop, undo, user-definable cell for¬ 
mats, hidden cells, custom row and column headings, 
conditional formatting virtual record handling and auto¬ 
matic recognition of date, time, fraction, currency, per¬ 
cent, and scientific entries. 

Formula One/VBX costs $295. For more information, 
contact VisualTools, Inc, 15721 College Blvd, Lenexa, KS 
66219,(913) 599-6500; fax (913) 599-6597; BBS (913) 
599-6713; CompuServe 72204,3521. 


ProtoView Adds NT Support 

ProtoView Development Corporation is shipping a 
version of ProtoGen+ for creating 32-bit Windows NT ap¬ 
plications. ProtoGen+ is an integrated visual develop¬ 
ment workbench for developing C/C++ Windows 
applications. ProtoGen+ lets you interactively construct 
the user interface for an application. A live test mode lets 
you interactively test the user interface under construc¬ 
tion without having to first compile and link. In addition 


to standard GUI prototyping features, ProtoGen+ in¬ 
cludes range validation, choice checking MDI support, 
toolbar support, dynamic status line functions, and a vari¬ 
ety of custom colors, fonts, and three-dimensional effects. 

ProtoGen+ for NT costs $495; owners of ProtGen+ 

4.X can upgrade for $99.95. For more information, con¬ 
tact ProtoView Development Co., 353 Georges Road Day- 
ton, NJ 08810, (908) 329-8588; fax (908) 329-8624. 


IDB Cuts Object Database Price in Half 

IDB Object Database is an object database with a C 
API for a variety of platforms, including Windows, Win¬ 
dows NT, UNIX, NeXTStep, and the Macintosh. The pack¬ 
age includes an interactive schema designer to help you 
model complex schema and create the underlying data¬ 
base. Persistent Data Systems, Inc. has now reduced the 
price of IDB Object Database for Windows 3.1 to $495 
for a single-user development license. The package is 
also available for $99 as an Introductory Package, which 
includes an introduction to object database technology. 


the working database, sample application and source 
code, and a tutorial. 

IDB Object Database for Windows costs $495; you 
can distribute the core database without any license fees 
as part of single-user applications on any platform. For 
more Information, contact Persistent Data Systems, Inc, 
75 West Chapel Ridge Road, Pittsburgh, PA 15238, (412) 
963-1843; fax (412)963-1846; Internet: info@per- 
sistcom. 
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Readers' Forum 


Hi, 

I'm writing to point out that what you called a 'bug' in 
Borland C++ with conditional operators ( W/DDJ June 
1994) is really a 'feature' mandated by the ISO/ANSI C++ 
committee. The grammar rule for the conditional operator 
has been changed from: 

conditional-expr: 

logical-or-expr 

logical-or-expr ’?’ expression conditional-expr 

to: 

conditional-expr: 

logical-or-expr 

logical-or-expr ’?’ expression assignment-expr 

which means that Borland C++ 4.0 is absolutely correct in 
its handling of the expression according to the latest draft 
of the ISO/ANSI C++ working paper. WATCOM C++ han¬ 
dies the code in the same way as Borland C++, also. Bor¬ 
land C++ 3.1 and MS C++ use the older precedence rule 
so this is the difference you noted. 

The change to the conditional operator was made be¬ 
cause an assignment expression is now: 

assignment-expr: 

conditional-expr 

unary-expr assignment-op assignment-expr 
throw-expr 

The change to the conditional operator was made so that: 

(1) assignments could be used on both halves of the 

(2) a throw expression could be on either side of the 

So, what you have discovered is an incompatibility be¬ 
tween the ARM definition of C++ and the current 
ISO/ANSI C++ definition, not a bug in Borland C++ 4.0. 
I'm pointing this out because if you used our compiler 
(WATCOM C++), you would have said that we had a prob¬ 
lem also when in fact all the compilers are correctly fol¬ 
lowing a moving target, the C++ language spec. 

Of course, your comment on destructing temporaries in 
conditional-expressions is a bug in Borland C++ (and 
CFRONT). 

Thanks for the interesting article and an interesting 
magazine! 


Anthony Scian 
WATCOM C/C++ 
<watcom.on.caIANTHONY@uunet.uu.net> 

Your letter raises several interesting issues, I think. First, I to¬ 
tally muffed it on that bug - I apologize to Borland for incor¬ 
rectly labeling this correct behavior as a bug. As you pointed out 
in further correspondence, this change by the ANSI committee 
was reported in "The C++ Report," which I try to read, but ap¬ 
parently did not that month! As I try to do for all the C++ bugs 
I’ve been writing up, I ran that one by the vendor's CompuServe 
tech support, but by now I am convinced that C++ is just too 
complex for the average tech support person to be an expert in, 
especially given the fact that it is a moving target. 

The second issue you raise for me is this: How will I avoid 
making this mistake in the future? What I've decided to do is try 
to make special arrangements with each vendor to review the 
bugs before we run them. Hopefully, that means that the bug 
will be seen by the folks in the back room who live and die by 
the syntax and semantics of the language, and who therefore 
will greatly reduce the chances of this particular kind of mistake 
happening again. Michael Hyman of Borland has already gra¬ 
ciously set up a channel for us to get vendor reviews of bugs 
related to their compiler and I will be talking to the other ven¬ 
dors in the next few weeks. 

I have mixed emotions about making this change because I 
really empathize with the average reader who has to convince 
the average tech support person that a bug really is a bug. 
However, I think that it is even more important for us to avoid 
errors in our bug coverage. I also think W/DDJ should not shy 
away from bugs that vendors may not entirely agree to be bugs 
(see this month's C++ bug for an example). The reason is that 
the average PC C++ programmer who types in a legal C++ 
program and gets a syntax error probably just assumes his/her 
code is wrong and therefore does not report a bug or ever use 
that particular syntax again. W/DDJ can play a role in encour¬ 
aging compiler vendors to implement as much of the language 
correctly as possible, and to avoid just "punting" when the go¬ 
ing (or the parsing) gets tough. 

One final issue your letter raised for me is Watcom C++ it¬ 
self. I recently received my first Watcom compiler and I plan to 
look into how difficult it would be to add it to the three compil¬ 
ers we already try to port W/DDJ code to. My most immediate 
hurdle is the need for more disk space to install it but if all goes 
well maybe we can add Watcom to the list this year. However, 
we won't have to wait that long for our first Watcom coverage, 
because Mark Nelson is taking over covering C++ bugs as a 
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regular feature. He already has plenty of experience with mak¬ 
ing code work with Watcom as well as the other three compil¬ 
ers, so I am relieved to have him on board. Thanks much for 
your letter and I hope you will continue to keep an eye on the 
accuracy of our C++ coverage, -rib 


Dear Ron: 

Thanks to Leor Zolman for selecting my tip (June issue; 
pp. 57-58) for publication and thanks to you for publish¬ 
ing it. However, as printed, the tip won't work; a couple of 
TO redirectors (greater-than signs) are missing. 

The commands as printed: 

type nul \empty.bat 
COMMAND /C \EMPTY PRN 

Correct commands: 

type nul >\empty.bat 
COMMAND /C \EMPTY>PRN 


Your printer evidently ran out of those signs. Here's a 
fresh supply: »»»»»»»»»»»»»»»> 
Thanks again. 

Homer B. Tilton 
Tucson, AZ 

Thanks for the correction and the fresh supply - our desktop 
publishing system has an unfortunate, sometimes ungov¬ 
ernable, appetite for angle brackets, -mm 


Hello: 

I'm clutching at straws, my company has a need to de¬ 
velop applications that ‘FUNCTION* in Chinese for use in 
our Hong Kong office. These applications need to function 
under either MS Windows or OS/2. I'm searching for any 
information, or leads to information that can be offered 
about development tools that will allow us to accomplish 
such a task. Any help, however small, is appreciated. 

Oliver Bell 
auamph7v@ibmmail.com 



Developer's 

Marketplace 


C and C++ DOCUMENTATION 


!! NEW VERSION 6.0 !! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates 
comment-blocks for each function, listing 
the functions and identifiers used by it. 

• C-METRIC ($59)Counts path complexity, 
counts comments, code, C’ statements. 

• C-LIST ($69) Lists and action-diagrams, 
or reformats into standard formats. 

• C-REF ($69) Creates cross-reference of 
local/global/define/parameter identifiers. 

• C-DOC ($199) PACKAGE All 5 programs 
integrated as DOS program (<10,000 lines) 
V6.0 C-TREE Windows grapic-tree viewer. 

• C-DOC Professional ($2991 DOS, Windows 
OS/2. 3-ring binder/case. <1,000,000 lines 

• 30-DAY Money-back guarantee CALL NOW 


SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga 

ONT, Canada Voice/Fax (905)-858-4466 

L5N-4M1 Demo/BBS (905)-85§-1916 


□ Request 134 on Reader Service Card □ 


DICE IS LOOKING FOR... 


...data processing, engineering and 
technical writing professionals to fill 
open positions nationwide. DICE is 
a FREE online job search service 
providing detailed information about 
current contract and full-time 
positions across the USA. It’s a 
confidential, easy to use, no cost 
way to search for a new job. 


DATA PROCESSING 
I NDEPENDENT 
CONSULTANT’S 
E XCHANGE 

ONLINE Number 
515 - 280-3423 

Contact DICE via 1200/14400 baud 
Modem, 8-N-1. 

A service of D&L Online, Inc. 
_ 515-280-1144 _ 

□ Request 161 on Reader Service Card □ 



Export Your 
Software Now 


Let us help you increase your export sales! 
Octagon develops foreign markets for 
small and medium size software publish¬ 
ers, including start-ups. 

• Quickly penetrate new markets 

• Conserve scarce internal resources 

• Find the best distributors and 
republishers for your product 

• All fees based on your success 




Octagon Trade 
Group, Inc. 

Suite 102, 3020 Pickett Rd„ #759 
Durham, NC 27705 
Tel: 919-493-1651 Fax: 919-493-1915 
E-Mail: octagon@mercury.interpath.net 

□ Request 177 on Reader Service Card o 
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Spend your time writing your App 
...Not wading through 
DDK documentation!! 
Hardware control for Win32’"Apps 
- without the Device Driver Kit 
''Port I/O 


''Memory I/O 

''Interrupts 

Ask us about Alpha™, PowerPC™ and 
Chicago versions. 

BlucWatcr Systems 
(206)771-3610 
(206)771-7758 Fax 

vv 73514 132@compuscrve.com 
/ | J LJ 1^ • ji NT version $595 

M Royalty free runtime 


Visa,MC, Approved PO 



□ Request 158 on Reader Service Card □ 
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Philosopht Software 


PC) Box 2152 • Cupertino • CA 95015-2152 
V/I 408.481.0565 • CompuServe 71205,2451 


□ Request 130 on Reader Service Card □ 



The 

TREASURE 
HUNTERS 

In the world of software, it is 
all too easy to lose a valuable 
treasure; by editing and saving 
a program, overwriting a vital 
previous version. ~ 

To prevent you from having to 
search in vain for buried treasures, 
ARIS VERSION TRACKING SYSTEM 
for Windows enables you to access 
and use previous program versions. 

AVTS. A gem of a program 
at a diamond price. 

1 2 1 ARIS 

Vt I Information-Systems 




□ Request 114 on Reader Service Card □ 


IMWHelp 


Windows Help Authoring Tool 


Professional quality help files 
in 1/4 the time!! 

• Edit text directly in IMWHelp 

• Build hypertext links to: topics, 
definitions, subjects 

• Glossary automatically created 

• Bitmaps incorporated 

• Desktop publishing features 

• Print topics, help file, customized 
reports 

• Spell check, replace verify/all 

• Easily reorganize topics, subjects, 
keywords 

• Uses Microsoft Help Compiler 

Single User: $89.95 

MC & Visa accepted, Shipping additional 

Call: IMCSI (212) 319-1903 

425 Madison Ave„ New York, NY 10017 


□ Request 141 on Reader Service Card o 



Add ZIP/UNZIP Power to your app's! 


DynaZIPcompreSn 

Toolkit for MicrosoffWindows 


Finally there's an intelligent and easy 
way to incorporate reading and writing 
of industry standard ZIP files into your 
Windows programs, without having to 
"shell" to DOS. 

DynaZIP is a high-qualily ROYALTY-FREE 
set of DLLs that give you a robust API for 
reading, testing, creating, writing, and 
updating your ZIP files. Supports C/C+ + 
and VB; includes source code for a 
high-qualily Windows-based ZIP shell, 
comprehensive test/diagnostic tools, 
and full documentation/help system. 
Versions available for Win3.1 and NT. 


Now only $249.00 w/30-day 
no-risk guarantee! 

Call today, toll free: (800) 962-2949 


Inner Media, Inc., Hollis NH USA (603) 465-3216, fax (603) 465-7195 
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WINDOWS DEVELOPERS! 


Text-to-Speech 
Speech Recognition 
Speech Compression 

Software Development Kits 
now available for Windows 3.1 ! 


Set your products apart! 
Speech is the ultimate user-interface! 


LERNOUT & HAUS PI El 
PRODUCTSl 


SPEECH 


800 W. Cummings Park, Suite 3100, Woburn. MA 01801 
(617) 932-4118 x202 Fax: (617) 932-9209 

(800) 252-4999 x202 
CALL FOR MORE INFORMATION 
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I Does your company 
provide tools, products, 
or services for advanced 
Windows programmers? 
Then reach over 21,000 
serious programmers in: 

Windows/DOS 

□ developers journal 

Call 913*841 >1631 today for 
information about 
advertising opportunities in 

Windows/DOS Developer’s Journal. 

Advanced. Serious. 

Technical. 


I Brian Osborn - Continental Europe. 

+49 431-396895 

I Ed - East I Christine - Midwest I Edwin - West 
913 - 841-1622 1913 - 841-6733 1913 - 841-1626 
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ULTRA-485 
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RS-485 with Windows and OS/2! 

Operating System independent. No additional 
drivers required. 

Automatic RS-485 Driver Enable, looks like 
RS-232 port 1 

IRQ’s 2-5,7,10-12,15 supported 16550 buff¬ 
ered UARTs Standard 
Made in USA 

Part #3055 Price: $179.00 

MAimsr* 

Communications 4 I/O Liberty, SC 29657 
(803) 843-4343 
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Sound & Vision Edition 

A hypertext / hypermedia Help Database Development Kit 
with two royalty free help engines and a help compiler with a 
built in cross reference tool. The current version is 10.0. 

ONE source generates help for MANY target formats like: 
Windows, OS/2, Microsoft Multimedia Viewer, THELP, 
DESQview/X, QuickHelp, PopHelp, word processors, text 
documents with table of contents, glossary and index. 

Write Once Help Many ! 

Supports Topics, PopUps, Links, Keywords, text formats, 
navigational and structural facilities, target code insertion, 
multiple module files, automatic Pascal/C/C++ reference 
generation, exception handling, graphics, sound, groups, 
multiple file target databases, Application Launch, user 
defined link templates, auto exports creation, and more. 

Get a demo version of HLPDK from CompuServe, Internet, 
PsL and other popular catalogs and BBS's. 

Order your copy from Hyper Act, Inc. or PsL today! 


$50 


+S&H 


HyperAct, Inc. 

P.O.Box 5517, Coralville, IA 52241 
Tel/Fax (319)351-8413 
CompuServe 76350,333 
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The only tool that jumps immediately to my mind is The In¬ 
ternationalization Toolkit (formerly known as The String Inter¬ 
nationalization Tools). I have not looked at the latest version, 
but I played with a previous version that seemed to do a decent 
job of automating the tedious task of getting string constants 
out of your code and managing separate string data for each 
environment you want to target I don't know how well this 
tool applies to the special needs of the Chinese locale. For more 
information, contact Network Dynamics, (804) 220-8771; FAX 
(804) 220-5741. Any readers out there know of other useful 
products in this area? -rib 


Subject: Your May C++ column 

I hope you won't think I'm picking nits if I point out 
that the term 'static constructor' doesn't make any sense. 
I think you mean 'constructor for a static object.' 

Isaac Rabinovitch 
ergo@netcom.com 


I originally sent a flip reply to your note, but upon reflection, 
I see that you have a very valid point While I certainly don't 
want to say "constructor for a static object" 16 times in an arti¬ 
cle, I should have at least spelled the term 'static constructor " 
out explicitly the first time I used it Because I use this term a lot 
in oral discussion of the language, it never even dawned on me 
that I was using an abbreviation. I will try to be more careful 
about this in the future. C++ is so crammed with syntactic and 
semantic widgets and gewgaws that liberal use of abbreviating 
jargon is necessary, otherwise each sentence is a paragraph 
long! -rib 


To: ronb@rdpub.com 
Subject: May Practical C++ in W/DDJ 
Quoting from your column: 

'Clearly, ErrorMessageO should get created before Lib- 
MainO is called and destroyed after WEPO is called. Sounds 
pretty simple, but apparently it was beyond the capabili¬ 
ties of both Microsoft and Symantec compilers." 
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X.25, SDLC, HDLC, FRAME RELAY, 
BSC ON THE PC 

Use the Sangoma SDLA card to 
provide synchronous support for your 
product that is cost effective, compliant, 
full featured, rock solid and easy to use. 

• Line speed to 180kbps 

• Compatible with all operating 
systems and environments 

• Operating statistics and built in 
datascope make your product easy 
to configure and debug 

• Primary and secondary SDLC with 
multiple addresses 

• HDLC LAPB, LAPD, NRM mode 

• CCITT 1988 X.25 implementation to 
ISO 8208 

SANGOMA Technologies Inc. 

Your communications Link 
Tel: (905) 474-1990; (800) 388-2475 
FAX: (905) 474-9223 


"If you can’t See it or Measure it... 
you can’t understand it!" 

PinPoint™ 

two new Windows tools for 
one low price: $199 

• Visual Tracer": See program 
execution flow in real time 

• Visual Profiler™: Measure function 
calling frequencies and execution 
times to 1 ms. Easy-to-use graphical 
display. 

Works AUTOMATICALLY with C/C++ and 
Microsoft" Visual Basic" 

Avanti Software, Inc. 

(800)329-8889x102 
International +1(415)329-8999 
FAX+1(415)329-8722 

90 day no-quibble guarantee 
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The Art of Visual Basic Programming ™ 

This amazing new book by J. D. Evans, Jr. unlocks 
the secrets of Windows and Visual Basic 
application design and programming. It explains 
Windows design from a unique and easy to 
understand perspective. Smart Objects, Hybrid 
Objects, Control Coupling, Events, Focus, Event 
Triggering, Visibility, Form and Module Code 
Placement, DLL Parameter Passing, Variable 
Scope, Strings, and Structures are described and 
explained. Enlightening allegories and annecdotes 
make this one of the most unusual and informative 
Windows books ever written. This book is the 
Rosetta stone for Windows and Visual Basic! 


Book: $29.95 Companion Disk: $9.95 
ETN Corporation 

RD4 Box 659 Montoursville, PA 17754-9433 
(717) 435-2202 (Sales) (717) 435-2802 (FAX) 
AMEX/MC/VISA/Check/MO/PO/COD 
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WinToAsm can deliver It! 

WlnToAsm 

Disassembles MS-Windows EXEs, 
DRVs, DLLs, and VxDS, by 
segment, range, or export. 

Labels exported and imported 
functions, VxD services, 
control proc, API entry, etc. 

Generates segment, export, 
import, and header tables. 

Supports batch-mode tagging of 
functions and data items 

ResToRC 

Decompiles resources to a RC file. 




J 'extract 

Extracts VxDs from Win386. 

All for only $94,951 
30-day Money-Back Guarantee 

Eclectic Software 

937 Jungfrau Court 
Milpitas.CA 95035 
(408) 262-3264 Voice/FAX 
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0 Shared DLL resources 
supports multiple applications 
and instances. 

0 Full post processing support 
& notification via messages 
(wait, no-wait, and polled), 

0 Complete NCB and attached 
data buffer functions simplify 
memory management. 

0 Complete documentation and 
on-line API help reference, 

0 Control panel utility allows 
dynamic DLL configuration. 

0 WINDOWS.TXT compatibilty 
for DOS support. 

0 No royalties, full source with 
demos. Now only $129.00! 


SIGMA SOFTWARE RESEARCH 

702 Windridge Dr., Atlanta, GA 30350 

© TEL/FAX (404) 992-0536 

Also available at the Programmer's ConnectionI 
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Create High 
Performance 
Network 
Applications 
FAST! 

Now Shipping 
Version 2.03! 

60 Day Money 
Back Guarantee! 


Phone Sound: Simple! 


For Windows/DOS Voice Mail & Fax Developers 



Professional 
Tools for 
your Voice 
Mail, Fax & 
Audiotex 
Applications 


1. Create fantastic prompts 
and save time with VFEdit ®! 
Record, crop, cut, copy, paste, 
mix, fade, echo, volume & 
more with your Dialogic™ 
D4x/12x boards. 

2. Add Voice Mail power to 
your MS Windows apps with 
TI/F DLL ™, our Tel I/F 
Dynamic Link Library. 

3. Audio Tool Box™ 
converts to and from 


Multimedia Wave (16, 8 & 
MS ADPCM), linear 16 & 
unsigned 8, plus Dialogic 4 & 
8 at any sample rate! 

4. Scribe Transcription 
Utility for DOS plays digital 
audio files in the background 
without voice mail hardware! 

5. Add Text-to-Speech 
capability to your apps with 
VoxFonts ™, our "software 
only" text-to-speech library! 


Order Now! 1-800-234-VISI 


[ Voice Information Systems: 24 N Merion Ave, Bryn Mawr, Pa 19010 I 
Tel:215-747-5035/ BBS:310-392-6610/ Fax 1-800-234-FX1T 



We Understand The 
Programmer's Mind 


When the country's top firms look for the 
best developers available, they turn to 
Bateman. Why? Because we specialize in 
Microsoft Windows, NT, OS/2 and Macin¬ 
tosh recruiting nationwide. So if it's time for 
a career move, give us a call. We under¬ 
stand your skills, and the marketplace for 
them... we understand you. 

□Bateman Inc. 

5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax: 310-641-2900 
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Diskette I/O 

Code Libraries 
Device Drivers 
VxDS 

Special Hardware 


Software for Conversion, 
Duplication, Analysis, 
and Data Recovery 


WE SPECIALIZE IN "ALIEN" 
NON-PC FORMATS. 

Write or call for a product brochure! 

W V7f~| PY PO Box 5700 

Eugene, OR 97405 

(800) 43-SYDEX or (503) 683-6033 
FAX (503) 683-1622 


lOO'S OF COMPILERS 
INTERPRETERS 
with SOURCE 
LANGUAGE/OS.$34.95 

RECENTLY UPDATED .. 

LARGEST collection of Source for 
Compilers, Libraries, & Docs for computer 
languages and OS on CD ROM. 

GRAPHICS.$24.95 

Tools and applications w/ source 
for all graphic capabilities 

AUDIO.$24.95 

Tools and applications w/ source 
for all audio capabilities 

MULTIMEDIA.$24.95 

Tools and applications w/ source 
to cre ate interactive multime dia. 

For a catalog of all our titles or to order, caH: 

KNOWLEDGE MEDIA INC.™ 

(800) 78 CD ROM (916) 872-7487 FAX (916) 872-3826 
VISA and MASTER CARD accepted 
436-B Nunnelew, Paradise, CA 95969 
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BRIDG IT™ 

Your Windows & DOS - dBConnection 



Bridgit is a full featured database engine that provides 
easy to use functions for creating, reading, updating 
and indexing dBase-lll+ and Clipper files. 

With Bridgit you create your application only once...then 
convert it to Windows or DOS using either dBase-lll+ or 
Clipper files. 

Order the ultimate database engine for Visual Basic 
and Visual C++ for just $69.95. 


Unelko Corporation 

Tel:(602) 991-7272 • Fax:(602) 483-7674 
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COMPUTER 
BOOKS 50% OFF! 

The Book Rack has the best titles 
from these great publishers S. more: 

IDG 

SAMS 

QUE 

MIS: Press 
Microsoft Press 
Sybex 

at HALF OFF cover prices! For a 
current list of available titles, call or fax: 

The Book Rack 

708-627-8122; Fax 708-932-9070 

Your Discount Book Source 

We ship anywhere! 

VISA/MasterCard/Discover accepted 


TCP/IP Tools 


Why write low-level TCP/IP code when you 
can quickly and easily incorporate 
high-level components? 

TELNET FTP W-82® 


T©P>UIB}[F> SIT.® TFtF 

PowerTCP lets you add TCP/IP protocols to 
your application without coding them yourself! 

VB & C/C++ Programming Interfaces 

Custom Development Available 

#1 Blm Phone: 315.841.8106 
Fax: 315.841.8107 

COMMUHICATIOHS 

6 Occum Ridge Road _ , 

Deansboro NY, 13328-1008 Sales@dart.com 
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WINDOWS 

JOBS! 

TechniSource, a leader in software 
engineering contracts and consulting is 
looking for MS WINDOWS professionals for 
Midwest, Southeast and Eastern locations: 

* Multimedia (video conferencing) 

* Device Drivers, Internals, GDI 

* 3.1, 4.0, NT 

* OLE 2.0 

* SDK, DLL's, VXD's 

* Visual C+ + 

* MS Test 

Highly compensated long term positions on 
cutting edge technology. 

TechniSource 

621 Plainfield Rd #301 Dept. WDD 
Willowbrook IL 60521 

800-330-3308, fax 708-887-1097 

CompuServe: 74407,3366 EOE 
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Be warned that I don't use C++ a lot, but my under¬ 
standing of the Windows kernel makes me think no com¬ 
piler could do as you suggest (correct as it is from a C++ 
point of view). The problem is that the Windows kernel 
calls LibMain as the first code executed in the DLL. There¬ 
fore there's no way for the compiler to arrange for your 
objects to be created at that point. 

Similarly, WEP is called during the unload process, on a 
temporary kernel stack, and after it returns the DLL is un¬ 
loaded and no further code executes in the DLL. Again, it 
seems to me to be impossible to execute any DLL code 
after the WEP. 

Does Borland handle this better? 

Dave Hart 
davehart@eskimo.com 

This is a confusing topic, so I'm glad you asked these ques¬ 
tions. I also used to think that LibMain() is the entry point of a 
DLL, but in fact, Windows calls an entry point based on some¬ 


thing else (I'm fuzzy on exactly what perhaps the first address in 
code segment 0?). Remember good old "libentry.asm" that you 
used to have to explicitly link in to create a DLL? That (or the 
equivalent in your compiler's DLL runtime code) is what really 
calls LibMain(). So, the compiler vendor can (and does) get con¬ 
trol and does various tasks before calling LibMain(). 

You're exactly right that WEP is the entry point for the un¬ 
load process, However, remember that if you just declare a func¬ 
tion called WEP() in C++, it will really be assigned a "mangled" 
name of _WEP_v_ or some such mush. Thus, what Borland 
does is supply a real WEP() (name not mangled) that Windows 
calls (as you point out, no clean way to subvert that mecha¬ 
nism), which then calls the mangled-name version (which is 
your C++ WEP()). 

The net result of the Borland approach is that if you have a 
C DLL with a LibMain() and a WEP(), and you convert it to use 
C++, it will work just as it did before, but constructors and de¬ 
structors for static objects will get called properly. I think their 
approach is the only reasonable way to go. -rib 
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We Pay $$$ 

If You Can Develop 
Applications That We Sell 

Here’s the deot 

— You develop products with our distributed 
application development tool: Control+ 

— We sell your applications for you. 

— We split the profits with you. 

Control+ resides on a Windows-PC, 
looks like a server to a C++ or VB 
client. It makes a text-based, host- 
resident applications into a server. 

If you are a serious, imaginative developer 
who is willing to risk $395, write or call: 

Executive Information Systems 
ATTN: Doug Daniel DougDaniel@aol.com 
1950 Neptune Road 510.606.1310 V 

Livermore, CA 94550 510.606.1315 F 

□ Request 152 on Reader Service Card □ 


Add a Drag ‘n’ Drop Style 
Graphical Interface to your 
Visual C++ Application with 
Drag-it Class Library 

=> Concentrate on your application while 
Drag-it handles the graphics ! 

=> Create Custom Palette by drawing 
using Drag-it Builder ! 

=> Track user’s actions at a higher level 
of abstraction than mouse moves! 

Only $495 including source 

To order call or fax today 
1-800-3-DRAG IT 

Perfofmij t 

6618 Daryn Dr., Westhills, CA 91307 
818-992-0840 fax: 818-347-9455 
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FREE Report 


How to Eliminate 87% 
of C Programming Errors 
in less than 2 hours! 

This valuable report reveals secrets 
known by less than 5% of all profes¬ 
sional programmers. These little 
known but powerful techniques prev¬ 
ent almost 90% of all design and main¬ 
tenance errors with the guarantee that 
your compiled code will be virtually 
error free. Limited quantity available. 

Logic Technologies 

1 (619) 228-9653 . FAX 1 (619) 369-1185 
^6089 29 Palms Hwy. Ste 254-CJ, Yucca Valley. CA 9228^1 
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Catch 22 

It goes like this: You have a saleable 
system (or close), but can’t devote the 
time and money to produce it, advertise 
it, or support it - So it sits there on your 
desk, earning nothing. Break out! We 
have money, professional marketers, 
programmers, technical support, doc 
writers, CPA, even legal counsel. We 
“wrap a company” around your product, 
take it from desktop to market - But it 
must be a commercial quality project 
marketable through print ads in maga¬ 
zines, direct mail, & telemarketing. You 
get 10-40% of net profit (depends on 
our $ and work input). Serious inquiries 
only. Describe program, target market, 
overall progress, etc. DO NOT send 
proprietary info or “ideas only”! Give 
address, phone #, time to call. Escape 
the startup paradox - Make It Happen! 

We Can Sell It For You 
Microscope, Inc. POB 691308 San Antonio TX 78269 
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ABSOLUTELY, 
POSITIVELY, 
NO MORE 


Vls T iHO 
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$5/disk, 

one issue per disk 
or ALL of 1993 
or 1992 for $20! 


Call today! 

913 - 841-1631 

FAX 913-841-2624 
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1601 West 23rd Street 
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All of these discs are Unconditionally Guaranteed! 

★ Cica MS Windows CDROM: 4000 Windows 
programs-quarterly updates! $29.95* 

★ C User Group Library CDROM: Collection 
of user supported C source code $49.95* 

★ Source Code CDROM: 650 MB of Unix & 

DOS source code $39.95 

★ Simtel MSDOS CDROM: Classic:650MB 
Shareware/Freeware for MSDOS $29.95* 

★ Hobbes OS/2 CDROM: 600 MB current 
Shareware/Freeware for OS/2 $29.95* 

★ Yggdrasil Linux CDROM: 32 bit O/S for PC 

w/ GNU & X11. Source code $49.95 

★ FreeBSD CDROM: Berkeley BSD, 32 bit 

O/S for PC, w/GNU & XI1 $39.95 

★ Internet Info CDROM: 12,000 computer, 
network, and internet documents $39.95 

★ Giga Games CDROM: 3000 hot Games for 

MSDOS and Windows $39.95* 

♦shareware requires separate payment to authors if found useful 

Pick up the pho ne and Call Now! 

1 -800-786-9907 tilin' 

1-510-674-0783 - FAX 1-510-674-0821 

email: orders@cdrom.com 

4041 Pike lane, Suite D-691 Concord, CA 94520 
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SpyWorks-VB 

For Visual Basic™ - Windows 

SpyWorks-VB allows you to do virtually 
anything in Visual Basic that is possible 
using other languages such as C. It 
includes controls that easily subclass 
VB forms and controls, detect keyboard 
events, and support callback functions. 
SpyWorks includes debugging tools to 
view message and event history, detect 
API parameter errors, Browse Windows 
memory and resources, and retrieve 
information about any window, form or 
control in the system. 

SpyWorks-VB is only $129 + $5 s&h ($15 
outside U.S & Canada). Visa/NIC orders 
include phone and exp. date. CA residents 
add 8.25% sales tax. Dual media - Requires 
VB2.0 

Desaw are 

5 Town & Country Village #790 

San Jose, CA 95128 

(408) 377-4770 fax:(408) 371-3530 
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WINDOWS DEVELOPERS 

I specialize in finding permanent and 
contract opportunities for Windows™ 
Developers. The market is excellent for 
talented software engineers. Focus on 
recruiting for Colorado and nationwide 
positions. All fees paid by the company. 
Give me a call at 1-800-638-8903. 

— Gary Patton 

SKEm 
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Windows 
Developer Jobs 

Specialists in jobs for software 
engineers in leading edge technology. 
Windows, PM, GUI, Languages, AI, 

Mac, CASE, Video, Realtime. 

Nationwide contacts with both large 
and small companies including equity 
startups. Many of our clients develop 
and publish commercial software 
products. Managed by graduate 
engineers. Never a fee to an 
applicant. 

1 - 800 - 231-5920 
Scientific Placement, Inc. 

SPI-8, Box 19949, Houston, TX 77224 (713) 496-6100 
SPI-8, Box 71, San Ramon, CA 94583 (510) 733-6168 
SPI-8, Box 4270, Johnson City, TN 37602 (615) 854-9444 
Fax: 713-496-6802 please use Fine Setting on Fax 
Email: Ascii preferred: Internet LSH@Scientific.com; 

userve: 71250,3001; Genie: D.SMALL6 _ > 
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OPTFFT 


^OPT-TECH SORT/MERGE^ 

Optimized Fast Fourier Transform 
(FFT) Library for DOS 


^ New -Version 5 

♦ Object file for linking with C or 

C++ routines 

♦ Written in assembler for 2X speed 
improvement 

♦ Up to 4096 real or complex points 


High performance Sort/Merge/Select 
utility. Run as a stand alone 
utility or CALL as a subroutine. 

Supports most languages and 
filetypes including Btrieve 
and dBase. Unlimited filesizes 
multiple keys and much more. 

MS-DOS, Windows $149 
OS/2, UNIX $249 

Call to order or for free info. 

♦ NO ROYALTIES 

♦ 30 day money-back guarantee 

plus $5 S&H 

Specify disk size. 


METRON Engineering, Inc. 

P.O. Box 14395 

Huntsville, AL 35815 

205-650-5250 

CIS: 76300, 3441 


Opt- Tech Data Processing 
P.O. Box 678 

Zephyr Cove, NV 89448 

L (702) 588-3737 
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E-Mail enable your Windows Apps in 
Minutes! 


Quickly add VIM, MAPI and MHS e-mail 
support to your applications! OMS works with 
any app capable of calling VBX's or DLL's. 
OMS/VBX - $495, OMS/DLL $995 Order now! 
V/M/A accepted. Also available through many 
programming catalogs. 

OMS, don't build your app without it! 

A 

Raindrop 

Software 

Raindrop Software Corporation 
833 E. Arapaho Road, Suite 104 
Richardson, TX 75081 
(214) 234-2611 Phone 
(214) 234-2674 Fax 
CIS: Go Raindrop, 74431,1411 
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IPX VBX/DLL 
NetBIOS VBX 



These custom controls allow a Visual 
Basic developer to write distributed. 

Our editor has speed, 

client/server applications. A separate 

a complete macro language, 

Windows dynamic-link library (DLL) is 

configurability, large file handling, 

available for IPX. 

compiler automation, and 
colorization. Cost? $89.95 


See for yourself. Download your 
unlimited eval copy. 

. NetBIOS $99 

rnJrTwilh * IPX/SPX $295 

NetWare 

Try a complete, free eval copy tonight! 


Our BBS: 206-935-5198 

' |'| - 

NET: ftp.halcyon.com /local/wilson 

A PI.YRY. 

CompuServe: WINAPA, Sec. 15 

AOL: WindowWare 

10201 W. Markham, Ste. 101 

Direct: 1-800-762-8383 

Little Rock, Arkansas 72205 

Wi/son WindowWare, Inc. 

Tel (501) 221-3600 • Fax (501) 221-7412 
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Tele: 303-779-8890 FAX: 303-779-8139 
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AccuSoft is now the recognized provider of 
the highest quality imaging toolkits in the 
world. Our performance, compatibility, 
ease-of-use, service, and our AccuSoft Image 
Guarantee have earned us this distinction. 
Our libraries save you hundreds of hours of 
work and provide your application with a 
unique advantage: Guaranteed Format Support. 

Incredibly Easy To Use 

Our toolkits are so easy to use that it should 
take you less than an hour to add complete 
image import, export, conversion, display, 
printing and scanning support to your appli¬ 
cation. If you need to work at a lower level 
for special situations, we have functions for 
that, too! 

Story Behind The Guarantee 

Having offered this Guarantee for over two 
years, we have collected several thousand 
(weird, but perfectly valid) images. Now¬ 
adays we see very few problem images. If we 
do, the image is usually corrupted or invalid, 
yet we are able to provide solutions for these 
images as well. 

Guaranteed to read all raster 
images in existence in the 
supported formats. If you 
can find a valid image we 
don't read, send it to us and 
we will make it work. 



Performance Tuned By Experts 

We at AccuSoft have an unyielding commit¬ 
ment to achieving the highest performance 
possible for all our products. This, of course, 
means that your 
products will also 
achieve greater 
performance. 

Support For All Platforms 

AccuSoft has versions for all major platforms 
including DOS, 32-bit DOS, Clipper, 
Foxpro, Windows™, Visual Basic®, 
Windows NT, OS/2, Chicago, Macintosh, 
and UNIX. We can also port to other sys¬ 
tems upon request. 

Complete Compression 

All forms of compression are supported 
including JPEG, Group III, Group IV, 
Packbits, LZW, Huffman, and more. Read 
any image format, then convert to any other 
format-with only two function calls! 

Features, Features, Features 

We provide a complete set of functions for 
printing, scanning, display, image processing 
and image handling. All printers and TWAIN 
scanners are supported with simple function 
calls. The image printing engine produces 
high quality output regardless of the printer. 
The display engine provides high-speed (up 
to 50 times faster than Windows) and high 
quality display for all types of images and 



AccuSoft is the Fastest! 


display modes. Our image processing func¬ 
tions include zoom, pan, scroll, invert, 
rotate, resize, sharpen, blur, contrast, bright¬ 
ness, palette optimization, color reduction, 
matrix convolutions and much more. 

Visual Basic® Versions 

We have special versions for Visual Basic 
that provide all the power of the DLL in the 
form of a Custom Control. We even have 
the world’s only 32-bit VBX for Windows 
3.1. Extremely Fast! 

Pro Gold Versions 

Our Pro Gold libraries represent the most 
advanced performance and features available 
in the world. We have Pro Gold versions 
available for Windows 3.1 (no special hard¬ 
ware or drivers required), Mac, UNIX and 
others. When your application demands 
unbeatable performance, go with Pro Gold. 

Call Now To Order 

800 - 525-3577 


Risk-Free 30-day money back guarantee on all 16-bit products. 



High Performance Imaging 


©Copyright 1994 AccuSoft Corporation. All Rights Reserved. AccuSoft Corporation 112 Turnpike Road Westborough, MA 01581 TEL:(508) 898-2770 FAX: (508) 898-9662 

□ Request 193 on Reader Service Card □ 












Get Inside WINDOWS! 


New 


Vers*"" 


1.5 


S«PP 


orts 



i 'Mr) 


*aE=* 

I 

llffi 



1 

\ I I I I Y | 

■ JIti jj'N 

- T9 

1 — /?'-" 





Microsoft 

WINDOWS 
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Debug Windows at the systems level! 


Soft-ICE/W takes you inside Windows! Debug and explore with power 
and flexibility not found in any other Windows debugger! Soft-ICE/W 
allows you to debug at the systems or applications level or simply learn 
the inner workings of Windows. 

• Debug VxD's, drivers and interrupt routines at source level 

• Debug interactions between DOS T&SR's and Windows Apps 

• Debug programs in DOS boxes 

• Display valuable system information 

(from the total memory occupied by a Windows application, to the 
complex internal structures of Windows) 

Soft-ICE/W uses the 386/486 architecture to provide break point 
capabilities that normally require external hardware. Nu-Mega, which 
pioneered this technology with the introduction of its award winning 
Soft/ICE for DOS, now gives Windows programmers the same debug¬ 
ging power... and still at a software price. 

Own the debugger that combines the best “view" of Windows internals 
with the most powerful break points of any software debugger. 

Soft-ICE/W. . . Only $ 386 


“While you may choose to keep your own favorite debugger 
for simple work, Soft-ICE/W will soon become mandatory 
equipment for serious windows debugging." 

PC Magazine 
June 1992 


- WHAT THE EXPERTS ARE SAYING - 

"Soft-ICE for Windows is great! It helped me 
find, in fifteen minutes, a killer bug in a 
Windows virtual device driver that had 
eluded two people for several months. I 
can't see doing Windows development of 
any kind -- whether writing Windows 
applications, device drivers, or even DOS 
programs that have to run under Windows -- 
without it. In addition to being great for 
finding bugs, Soft-ICE for Windows has been 
essential for my work on a forthcoming book: 
on Undocumented Windows . Soft-ICE for 
Windows goes anywhere and does 
everything, so it's essential for anyone who 
wants to poke around inside Windows 
Enhanced mode. DOS programmers will find 
it a perfect way to learn how the Windows 
DOS extender and DPMI server work, and 
how Windows interacts with DOS. Windows 
Enhanced mode is the hacker's paradise of 
the 90s, and Soft-ICE for Windows is the tool 
that every serious Windows or DOS hacker 
will need, Nu-Mega has done a brilliant 
job!" 

Andrew Schulman 

Software Engineer 

Editor, Undocumented DOS 

Coauthor, Undocumented Windows 


Call ( 603 ) 889-2386 


RISK = NULL 

30 DAY 

MONEY-BACK GUARANTEE 

fax ( 603 ) 889-1135 
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603-595-0386 
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